This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
produce better error message when \N{...} is used without
[perl5.git] / toke.c
1 /*    toke.c
2  *
3  *    Copyright (c) 1991-2000, Larry Wall
4  *
5  *    You may distribute under the terms of either the GNU General Public
6  *    License or the Artistic License, as specified in the README file.
7  *
8  */
9
10 /*
11  *   "It all comes from here, the stench and the peril."  --Frodo
12  */
13
14 /*
15  * This file is the lexer for Perl.  It's closely linked to the
16  * parser, perly.y.  
17  *
18  * The main routine is yylex(), which returns the next token.
19  */
20
21 #include "EXTERN.h"
22 #define PERL_IN_TOKE_C
23 #include "perl.h"
24
25 #define yychar  PL_yychar
26 #define yylval  PL_yylval
27
28 static char ident_too_long[] = "Identifier too long";
29
30 static void restore_rsfp(pTHXo_ void *f);
31
32 #define XFAKEBRACK 128
33 #define XENUMMASK 127
34
35 /*#define UTF (SvUTF8(PL_linestr) && !(PL_hints & HINT_BYTE))*/
36 #define UTF (PL_hints & HINT_UTF8)
37
38 /* In variables name $^X, these are the legal values for X.  
39  * 1999-02-27 mjd-perl-patch@plover.com */
40 #define isCONTROLVAR(x) (isUPPER(x) || strchr("[\\]^_?", (x)))
41
42 /* LEX_* are values for PL_lex_state, the state of the lexer.
43  * They are arranged oddly so that the guard on the switch statement
44  * can get by with a single comparison (if the compiler is smart enough).
45  */
46
47 /* #define LEX_NOTPARSING               11 is done in perl.h. */
48
49 #define LEX_NORMAL              10
50 #define LEX_INTERPNORMAL         9
51 #define LEX_INTERPCASEMOD        8
52 #define LEX_INTERPPUSH           7
53 #define LEX_INTERPSTART          6
54 #define LEX_INTERPEND            5
55 #define LEX_INTERPENDMAYBE       4
56 #define LEX_INTERPCONCAT         3
57 #define LEX_INTERPCONST          2
58 #define LEX_FORMLINE             1
59 #define LEX_KNOWNEXT             0
60
61 /* XXX If this causes problems, set i_unistd=undef in the hint file.  */
62 #ifdef I_UNISTD
63 #  include <unistd.h> /* Needed for execv() */
64 #endif
65
66
67 #ifdef ff_next
68 #undef ff_next
69 #endif
70
71 #ifdef USE_PURE_BISON
72 YYSTYPE* yylval_pointer = NULL;
73 int* yychar_pointer = NULL;
74 #  undef yylval
75 #  undef yychar
76 #  define yylval (*yylval_pointer)
77 #  define yychar (*yychar_pointer)
78 #  define PERL_YYLEX_PARAM yylval_pointer,yychar_pointer
79 #  undef yylex
80 #  define yylex()       Perl_yylex(aTHX_ yylval_pointer, yychar_pointer)
81 #endif
82
83 #include "keywords.h"
84
85 /* CLINE is a macro that ensures PL_copline has a sane value */
86
87 #ifdef CLINE
88 #undef CLINE
89 #endif
90 #define CLINE (PL_copline = (CopLINE(PL_curcop) < PL_copline ? CopLINE(PL_curcop) : PL_copline))
91
92 /*
93  * Convenience functions to return different tokens and prime the
94  * lexer for the next token.  They all take an argument.
95  *
96  * TOKEN        : generic token (used for '(', DOLSHARP, etc)
97  * OPERATOR     : generic operator
98  * AOPERATOR    : assignment operator
99  * PREBLOCK     : beginning the block after an if, while, foreach, ...
100  * PRETERMBLOCK : beginning a non-code-defining {} block (eg, hash ref)
101  * PREREF       : *EXPR where EXPR is not a simple identifier
102  * TERM         : expression term
103  * LOOPX        : loop exiting command (goto, last, dump, etc)
104  * FTST         : file test operator
105  * FUN0         : zero-argument function
106  * FUN1         : not used, except for not, which isn't a UNIOP
107  * BOop         : bitwise or or xor
108  * BAop         : bitwise and
109  * SHop         : shift operator
110  * PWop         : power operator
111  * PMop         : pattern-matching operator
112  * Aop          : addition-level operator
113  * Mop          : multiplication-level operator
114  * Eop          : equality-testing operator
115  * Rop        : relational operator <= != gt
116  *
117  * Also see LOP and lop() below.
118  */
119
120 #define TOKEN(retval) return (PL_bufptr = s,(int)retval)
121 #define OPERATOR(retval) return (PL_expect = XTERM,PL_bufptr = s,(int)retval)
122 #define AOPERATOR(retval) return ao((PL_expect = XTERM,PL_bufptr = s,(int)retval))
123 #define PREBLOCK(retval) return (PL_expect = XBLOCK,PL_bufptr = s,(int)retval)
124 #define PRETERMBLOCK(retval) return (PL_expect = XTERMBLOCK,PL_bufptr = s,(int)retval)
125 #define PREREF(retval) return (PL_expect = XREF,PL_bufptr = s,(int)retval)
126 #define TERM(retval) return (CLINE, PL_expect = XOPERATOR,PL_bufptr = s,(int)retval)
127 #define LOOPX(f) return(yylval.ival=f,PL_expect = XTERM,PL_bufptr = s,(int)LOOPEX)
128 #define FTST(f) return(yylval.ival=f,PL_expect = XTERM,PL_bufptr = s,(int)UNIOP)
129 #define FUN0(f) return(yylval.ival = f,PL_expect = XOPERATOR,PL_bufptr = s,(int)FUNC0)
130 #define FUN1(f) return(yylval.ival = f,PL_expect = XOPERATOR,PL_bufptr = s,(int)FUNC1)
131 #define BOop(f) return ao((yylval.ival=f,PL_expect = XTERM,PL_bufptr = s,(int)BITOROP))
132 #define BAop(f) return ao((yylval.ival=f,PL_expect = XTERM,PL_bufptr = s,(int)BITANDOP))
133 #define SHop(f) return ao((yylval.ival=f,PL_expect = XTERM,PL_bufptr = s,(int)SHIFTOP))
134 #define PWop(f) return ao((yylval.ival=f,PL_expect = XTERM,PL_bufptr = s,(int)POWOP))
135 #define PMop(f) return(yylval.ival=f,PL_expect = XTERM,PL_bufptr = s,(int)MATCHOP)
136 #define Aop(f) return ao((yylval.ival=f,PL_expect = XTERM,PL_bufptr = s,(int)ADDOP))
137 #define Mop(f) return ao((yylval.ival=f,PL_expect = XTERM,PL_bufptr = s,(int)MULOP))
138 #define Eop(f) return(yylval.ival=f,PL_expect = XTERM,PL_bufptr = s,(int)EQOP)
139 #define Rop(f) return(yylval.ival=f,PL_expect = XTERM,PL_bufptr = s,(int)RELOP)
140
141 /* This bit of chicanery makes a unary function followed by
142  * a parenthesis into a function with one argument, highest precedence.
143  */
144 #define UNI(f) return(yylval.ival = f, \
145         PL_expect = XTERM, \
146         PL_bufptr = s, \
147         PL_last_uni = PL_oldbufptr, \
148         PL_last_lop_op = f, \
149         (*s == '(' || (s = skipspace(s), *s == '(') ? (int)FUNC1 : (int)UNIOP) )
150
151 #define UNIBRACK(f) return(yylval.ival = f, \
152         PL_bufptr = s, \
153         PL_last_uni = PL_oldbufptr, \
154         (*s == '(' || (s = skipspace(s), *s == '(') ? (int)FUNC1 : (int)UNIOP) )
155
156 /* grandfather return to old style */
157 #define OLDLOP(f) return(yylval.ival=f,PL_expect = XTERM,PL_bufptr = s,(int)LSTOP)
158
159 /*
160  * S_ao
161  *
162  * This subroutine detects &&= and ||= and turns an ANDAND or OROR
163  * into an OP_ANDASSIGN or OP_ORASSIGN
164  */
165
166 STATIC int
167 S_ao(pTHX_ int toketype)
168 {
169     if (*PL_bufptr == '=') {
170         PL_bufptr++;
171         if (toketype == ANDAND)
172             yylval.ival = OP_ANDASSIGN;
173         else if (toketype == OROR)
174             yylval.ival = OP_ORASSIGN;
175         toketype = ASSIGNOP;
176     }
177     return toketype;
178 }
179
180 /*
181  * S_no_op
182  * When Perl expects an operator and finds something else, no_op
183  * prints the warning.  It always prints "<something> found where
184  * operator expected.  It prints "Missing semicolon on previous line?"
185  * if the surprise occurs at the start of the line.  "do you need to
186  * predeclare ..." is printed out for code like "sub bar; foo bar $x"
187  * where the compiler doesn't know if foo is a method call or a function.
188  * It prints "Missing operator before end of line" if there's nothing
189  * after the missing operator, or "... before <...>" if there is something
190  * after the missing operator.
191  */
192
193 STATIC void
194 S_no_op(pTHX_ char *what, char *s)
195 {
196     char *oldbp = PL_bufptr;
197     bool is_first = (PL_oldbufptr == PL_linestart);
198
199     if (!s)
200         s = oldbp;
201     else {
202         assert(s >= oldbp);
203         PL_bufptr = s;
204     }
205     yywarn(Perl_form(aTHX_ "%s found where operator expected", what));
206     if (is_first)
207         Perl_warn(aTHX_ "\t(Missing semicolon on previous line?)\n");
208     else if (PL_oldoldbufptr && isIDFIRST_lazy_if(PL_oldoldbufptr,UTF)) {
209         char *t;
210         for (t = PL_oldoldbufptr; *t && (isALNUM_lazy_if(t,UTF) || *t == ':'); t++) ;
211         if (t < PL_bufptr && isSPACE(*t))
212             Perl_warn(aTHX_ "\t(Do you need to predeclare %.*s?)\n",
213                 t - PL_oldoldbufptr, PL_oldoldbufptr);
214     }
215     else
216         Perl_warn(aTHX_ "\t(Missing operator before %.*s?)\n", s - oldbp, oldbp);
217     PL_bufptr = oldbp;
218 }
219
220 /*
221  * S_missingterm
222  * Complain about missing quote/regexp/heredoc terminator.
223  * If it's called with (char *)NULL then it cauterizes the line buffer.
224  * If we're in a delimited string and the delimiter is a control
225  * character, it's reformatted into a two-char sequence like ^C.
226  * This is fatal.
227  */
228
229 STATIC void
230 S_missingterm(pTHX_ char *s)
231 {
232     char tmpbuf[3];
233     char q;
234     if (s) {
235         char *nl = strrchr(s,'\n');
236         if (nl)
237             *nl = '\0';
238     }
239     else if (
240 #ifdef EBCDIC
241         iscntrl(PL_multi_close)
242 #else
243         PL_multi_close < 32 || PL_multi_close == 127
244 #endif
245         ) {
246         *tmpbuf = '^';
247         tmpbuf[1] = toCTRL(PL_multi_close);
248         s = "\\n";
249         tmpbuf[2] = '\0';
250         s = tmpbuf;
251     }
252     else {
253         *tmpbuf = PL_multi_close;
254         tmpbuf[1] = '\0';
255         s = tmpbuf;
256     }
257     q = strchr(s,'"') ? '\'' : '"';
258     Perl_croak(aTHX_ "Can't find string terminator %c%s%c anywhere before EOF",q,s,q);
259 }
260
261 /*
262  * Perl_deprecate
263  */
264
265 void
266 Perl_deprecate(pTHX_ char *s)
267 {
268     dTHR;
269     if (ckWARN(WARN_DEPRECATED))
270         Perl_warner(aTHX_ WARN_DEPRECATED, "Use of %s is deprecated", s);
271 }
272
273 /*
274  * depcom
275  * Deprecate a comma-less variable list.
276  */
277
278 STATIC void
279 S_depcom(pTHX)
280 {
281     deprecate("comma-less variable list");
282 }
283
284 /*
285  * experimental text filters for win32 carriage-returns, utf16-to-utf8 and
286  * utf16-to-utf8-reversed.
287  */
288
289 #ifdef PERL_CR_FILTER
290 static void
291 strip_return(SV *sv)
292 {
293     register char *s = SvPVX(sv);
294     register char *e = s + SvCUR(sv);
295     /* outer loop optimized to do nothing if there are no CR-LFs */
296     while (s < e) {
297         if (*s++ == '\r' && *s == '\n') {
298             /* hit a CR-LF, need to copy the rest */
299             register char *d = s - 1;
300             *d++ = *s++;
301             while (s < e) {
302                 if (*s == '\r' && s[1] == '\n')
303                     s++;
304                 *d++ = *s++;
305             }
306             SvCUR(sv) -= s - d;
307             return;
308         }
309     }
310 }
311
312 STATIC I32
313 S_cr_textfilter(pTHX_ int idx, SV *sv, int maxlen)
314 {
315     I32 count = FILTER_READ(idx+1, sv, maxlen);
316     if (count > 0 && !maxlen)
317         strip_return(sv);
318     return count;
319 }
320 #endif
321
322 #if 0
323 STATIC I32
324 S_utf16_textfilter(pTHX_ int idx, SV *sv, int maxlen)
325 {
326     I32 count = FILTER_READ(idx+1, sv, maxlen);
327     if (count) {
328         U8* tmps;
329         U8* tend;
330         New(898, tmps, SvCUR(sv) * 3 / 2 + 1, U8);
331         tend = utf16_to_utf8((U16*)SvPVX(sv), tmps, SvCUR(sv));
332         sv_usepvn(sv, (char*)tmps, tend - tmps);
333     }
334     return count;
335 }
336
337 STATIC I32
338 S_utf16rev_textfilter(pTHX_ int idx, SV *sv, int maxlen)
339 {
340     I32 count = FILTER_READ(idx+1, sv, maxlen);
341     if (count) {
342         U8* tmps;
343         U8* tend;
344         New(898, tmps, SvCUR(sv) * 3 / 2 + 1, U8);
345         tend = utf16_to_utf8_reversed((U16*)SvPVX(sv), tmps, SvCUR(sv));
346         sv_usepvn(sv, (char*)tmps, tend - tmps);
347     }
348     return count;
349 }
350 #endif
351
352 /*
353  * Perl_lex_start
354  * Initialize variables.  Uses the Perl save_stack to save its state (for
355  * recursive calls to the parser).
356  */
357
358 void
359 Perl_lex_start(pTHX_ SV *line)
360 {
361     dTHR;
362     char *s;
363     STRLEN len;
364
365     SAVEI32(PL_lex_dojoin);
366     SAVEI32(PL_lex_brackets);
367     SAVEI32(PL_lex_casemods);
368     SAVEI32(PL_lex_starts);
369     SAVEI32(PL_lex_state);
370     SAVEVPTR(PL_lex_inpat);
371     SAVEI32(PL_lex_inwhat);
372     if (PL_lex_state == LEX_KNOWNEXT) {
373         I32 toke = PL_nexttoke;
374         while (--toke >= 0) {
375             SAVEI32(PL_nexttype[toke]);
376             SAVEVPTR(PL_nextval[toke]);
377         }
378         SAVEI32(PL_nexttoke);
379         PL_nexttoke = 0;
380     }
381     SAVECOPLINE(PL_curcop);
382     SAVEPPTR(PL_bufptr);
383     SAVEPPTR(PL_bufend);
384     SAVEPPTR(PL_oldbufptr);
385     SAVEPPTR(PL_oldoldbufptr);
386     SAVEPPTR(PL_linestart);
387     SAVESPTR(PL_linestr);
388     SAVEPPTR(PL_lex_brackstack);
389     SAVEPPTR(PL_lex_casestack);
390     SAVEDESTRUCTOR_X(restore_rsfp, PL_rsfp);
391     SAVESPTR(PL_lex_stuff);
392     SAVEI32(PL_lex_defer);
393     SAVEI32(PL_sublex_info.sub_inwhat);
394     SAVESPTR(PL_lex_repl);
395     SAVEINT(PL_expect);
396     SAVEINT(PL_lex_expect);
397
398     PL_lex_state = LEX_NORMAL;
399     PL_lex_defer = 0;
400     PL_expect = XSTATE;
401     PL_lex_brackets = 0;
402     New(899, PL_lex_brackstack, 120, char);
403     New(899, PL_lex_casestack, 12, char);
404     SAVEFREEPV(PL_lex_brackstack);
405     SAVEFREEPV(PL_lex_casestack);
406     PL_lex_casemods = 0;
407     *PL_lex_casestack = '\0';
408     PL_lex_dojoin = 0;
409     PL_lex_starts = 0;
410     PL_lex_stuff = Nullsv;
411     PL_lex_repl = Nullsv;
412     PL_lex_inpat = 0;
413     PL_lex_inwhat = 0;
414     PL_sublex_info.sub_inwhat = 0;
415     PL_linestr = line;
416     if (SvREADONLY(PL_linestr))
417         PL_linestr = sv_2mortal(newSVsv(PL_linestr));
418     s = SvPV(PL_linestr, len);
419     if (len && s[len-1] != ';') {
420         if (!(SvFLAGS(PL_linestr) & SVs_TEMP))
421             PL_linestr = sv_2mortal(newSVsv(PL_linestr));
422         sv_catpvn(PL_linestr, "\n;", 2);
423     }
424     SvTEMP_off(PL_linestr);
425     PL_oldoldbufptr = PL_oldbufptr = PL_bufptr = PL_linestart = SvPVX(PL_linestr);
426     PL_bufend = PL_bufptr + SvCUR(PL_linestr);
427     SvREFCNT_dec(PL_rs);
428     PL_rs = newSVpvn("\n", 1);
429     PL_rsfp = 0;
430 }
431
432 /*
433  * Perl_lex_end
434  * Finalizer for lexing operations.  Must be called when the parser is
435  * done with the lexer.
436  */
437
438 void
439 Perl_lex_end(pTHX)
440 {
441     PL_doextract = FALSE;
442 }
443
444 /*
445  * S_incline
446  * This subroutine has nothing to do with tilting, whether at windmills
447  * or pinball tables.  Its name is short for "increment line".  It
448  * increments the current line number in CopLINE(PL_curcop) and checks
449  * to see whether the line starts with a comment of the form
450  *    # line 500 "foo.pm"
451  * If so, it sets the current line number and file to the values in the comment.
452  */
453
454 STATIC void
455 S_incline(pTHX_ char *s)
456 {
457     dTHR;
458     char *t;
459     char *n;
460     char *e;
461     char ch;
462
463     CopLINE_inc(PL_curcop);
464     if (*s++ != '#')
465         return;
466     while (*s == ' ' || *s == '\t') s++;
467     if (strnEQ(s, "line", 4))
468         s += 4;
469     else
470         return;
471     if (*s == ' ' || *s == '\t')
472         s++;
473     else 
474         return;
475     while (*s == ' ' || *s == '\t') s++;
476     if (!isDIGIT(*s))
477         return;
478     n = s;
479     while (isDIGIT(*s))
480         s++;
481     while (*s == ' ' || *s == '\t')
482         s++;
483     if (*s == '"' && (t = strchr(s+1, '"'))) {
484         s++;
485         e = t + 1;
486     }
487     else {
488         for (t = s; !isSPACE(*t); t++) ;
489         e = t;
490     }
491     while (*e == ' ' || *e == '\t' || *e == '\r' || *e == '\f')
492         e++;
493     if (*e != '\n' && *e != '\0')
494         return;         /* false alarm */
495
496     ch = *t;
497     *t = '\0';
498     if (t - s > 0)
499         CopFILE_set(PL_curcop, s);
500     *t = ch;
501     CopLINE_set(PL_curcop, atoi(n)-1);
502 }
503
504 /*
505  * S_skipspace
506  * Called to gobble the appropriate amount and type of whitespace.
507  * Skips comments as well.
508  */
509
510 STATIC char *
511 S_skipspace(pTHX_ register char *s)
512 {
513     dTHR;
514     if (PL_lex_formbrack && PL_lex_brackets <= PL_lex_formbrack) {
515         while (s < PL_bufend && (*s == ' ' || *s == '\t'))
516             s++;
517         return s;
518     }
519     for (;;) {
520         STRLEN prevlen;
521         SSize_t oldprevlen, oldoldprevlen;
522         SSize_t oldloplen, oldunilen;
523         while (s < PL_bufend && isSPACE(*s)) {
524             if (*s++ == '\n' && PL_in_eval && !PL_rsfp)
525                 incline(s);
526         }
527
528         /* comment */
529         if (s < PL_bufend && *s == '#') {
530             while (s < PL_bufend && *s != '\n')
531                 s++;
532             if (s < PL_bufend) {
533                 s++;
534                 if (PL_in_eval && !PL_rsfp) {
535                     incline(s);
536                     continue;
537                 }
538             }
539         }
540
541         /* only continue to recharge the buffer if we're at the end
542          * of the buffer, we're not reading from a source filter, and
543          * we're in normal lexing mode
544          */
545         if (s < PL_bufend || !PL_rsfp || PL_sublex_info.sub_inwhat ||
546                 PL_lex_state == LEX_FORMLINE)
547             return s;
548
549         /* try to recharge the buffer */
550         if ((s = filter_gets(PL_linestr, PL_rsfp,
551                              (prevlen = SvCUR(PL_linestr)))) == Nullch)
552         {
553             /* end of file.  Add on the -p or -n magic */
554             if (PL_minus_n || PL_minus_p) {
555                 sv_setpv(PL_linestr,PL_minus_p ?
556                          ";}continue{print or die qq(-p destination: $!\\n)" :
557                          "");
558                 sv_catpv(PL_linestr,";}");
559                 PL_minus_n = PL_minus_p = 0;
560             }
561             else
562                 sv_setpv(PL_linestr,";");
563
564             /* reset variables for next time we lex */
565             PL_oldoldbufptr = PL_oldbufptr = PL_bufptr = s = PL_linestart
566                 = SvPVX(PL_linestr);
567             PL_bufend = SvPVX(PL_linestr) + SvCUR(PL_linestr);
568
569             /* Close the filehandle.  Could be from -P preprocessor,
570              * STDIN, or a regular file.  If we were reading code from
571              * STDIN (because the commandline held no -e or filename)
572              * then we don't close it, we reset it so the code can
573              * read from STDIN too.
574              */
575
576             if (PL_preprocess && !PL_in_eval)
577                 (void)PerlProc_pclose(PL_rsfp);
578             else if ((PerlIO*)PL_rsfp == PerlIO_stdin())
579                 PerlIO_clearerr(PL_rsfp);
580             else
581                 (void)PerlIO_close(PL_rsfp);
582             PL_rsfp = Nullfp;
583             return s;
584         }
585
586         /* not at end of file, so we only read another line */
587         /* make corresponding updates to old pointers, for yyerror() */
588         oldprevlen = PL_oldbufptr - PL_bufend;
589         oldoldprevlen = PL_oldoldbufptr - PL_bufend;
590         if (PL_last_uni)
591             oldunilen = PL_last_uni - PL_bufend;
592         if (PL_last_lop)
593             oldloplen = PL_last_lop - PL_bufend;
594         PL_linestart = PL_bufptr = s + prevlen;
595         PL_bufend = s + SvCUR(PL_linestr);
596         s = PL_bufptr;
597         PL_oldbufptr = s + oldprevlen;
598         PL_oldoldbufptr = s + oldoldprevlen;
599         if (PL_last_uni)
600             PL_last_uni = s + oldunilen;
601         if (PL_last_lop)
602             PL_last_lop = s + oldloplen;
603         incline(s);
604
605         /* debugger active and we're not compiling the debugger code,
606          * so store the line into the debugger's array of lines
607          */
608         if (PERLDB_LINE && PL_curstash != PL_debstash) {
609             SV *sv = NEWSV(85,0);
610
611             sv_upgrade(sv, SVt_PVMG);
612             sv_setpvn(sv,PL_bufptr,PL_bufend-PL_bufptr);
613             av_store(CopFILEAV(PL_curcop),(I32)CopLINE(PL_curcop),sv);
614         }
615     }
616 }
617
618 /*
619  * S_check_uni
620  * Check the unary operators to ensure there's no ambiguity in how they're
621  * used.  An ambiguous piece of code would be:
622  *     rand + 5
623  * This doesn't mean rand() + 5.  Because rand() is a unary operator,
624  * the +5 is its argument.
625  */
626
627 STATIC void
628 S_check_uni(pTHX)
629 {
630     char *s;
631     char *t;
632     dTHR;
633
634     if (PL_oldoldbufptr != PL_last_uni)
635         return;
636     while (isSPACE(*PL_last_uni))
637         PL_last_uni++;
638     for (s = PL_last_uni; isALNUM_lazy_if(s,UTF) || *s == '-'; s++) ;
639     if ((t = strchr(s, '(')) && t < PL_bufptr)
640         return;
641     if (ckWARN_d(WARN_AMBIGUOUS)){
642         char ch = *s;
643         *s = '\0';
644         Perl_warner(aTHX_ WARN_AMBIGUOUS, 
645                    "Warning: Use of \"%s\" without parens is ambiguous", 
646                    PL_last_uni);
647         *s = ch;
648     }
649 }
650
651 /* workaround to replace the UNI() macro with a function.  Only the
652  * hints/uts.sh file mentions this.  Other comments elsewhere in the
653  * source indicate Microport Unix might need it too.
654  */
655
656 #ifdef CRIPPLED_CC
657
658 #undef UNI
659 #define UNI(f) return uni(f,s)
660
661 STATIC int
662 S_uni(pTHX_ I32 f, char *s)
663 {
664     yylval.ival = f;
665     PL_expect = XTERM;
666     PL_bufptr = s;
667     PL_last_uni = PL_oldbufptr;
668     PL_last_lop_op = f;
669     if (*s == '(')
670         return FUNC1;
671     s = skipspace(s);
672     if (*s == '(')
673         return FUNC1;
674     else
675         return UNIOP;
676 }
677
678 #endif /* CRIPPLED_CC */
679
680 /*
681  * LOP : macro to build a list operator.  Its behaviour has been replaced
682  * with a subroutine, S_lop() for which LOP is just another name.
683  */
684
685 #define LOP(f,x) return lop(f,x,s)
686
687 /*
688  * S_lop
689  * Build a list operator (or something that might be one).  The rules:
690  *  - if we have a next token, then it's a list operator [why?]
691  *  - if the next thing is an opening paren, then it's a function
692  *  - else it's a list operator
693  */
694
695 STATIC I32
696 S_lop(pTHX_ I32 f, int x, char *s)
697 {
698     dTHR;
699     yylval.ival = f;
700     CLINE;
701     PL_expect = x;
702     PL_bufptr = s;
703     PL_last_lop = PL_oldbufptr;
704     PL_last_lop_op = f;
705     if (PL_nexttoke)
706         return LSTOP;
707     if (*s == '(')
708         return FUNC;
709     s = skipspace(s);
710     if (*s == '(')
711         return FUNC;
712     else
713         return LSTOP;
714 }
715
716 /*
717  * S_force_next
718  * When the lexer realizes it knows the next token (for instance,
719  * it is reordering tokens for the parser) then it can call S_force_next
720  * to know what token to return the next time the lexer is called.  Caller
721  * will need to set PL_nextval[], and possibly PL_expect to ensure the lexer
722  * handles the token correctly.
723  */
724
725 STATIC void 
726 S_force_next(pTHX_ I32 type)
727 {
728     PL_nexttype[PL_nexttoke] = type;
729     PL_nexttoke++;
730     if (PL_lex_state != LEX_KNOWNEXT) {
731         PL_lex_defer = PL_lex_state;
732         PL_lex_expect = PL_expect;
733         PL_lex_state = LEX_KNOWNEXT;
734     }
735 }
736
737 /*
738  * S_force_word
739  * When the lexer knows the next thing is a word (for instance, it has
740  * just seen -> and it knows that the next char is a word char, then
741  * it calls S_force_word to stick the next word into the PL_next lookahead.
742  *
743  * Arguments:
744  *   char *start : buffer position (must be within PL_linestr)
745  *   int token   : PL_next will be this type of bare word (e.g., METHOD,WORD)
746  *   int check_keyword : if true, Perl checks to make sure the word isn't
747  *       a keyword (do this if the word is a label, e.g. goto FOO)
748  *   int allow_pack : if true, : characters will also be allowed (require,
749  *       use, etc. do this)
750  *   int allow_initial_tick : used by the "sub" lexer only.
751  */
752
753 STATIC char *
754 S_force_word(pTHX_ register char *start, int token, int check_keyword, int allow_pack, int allow_initial_tick)
755 {
756     register char *s;
757     STRLEN len;
758     
759     start = skipspace(start);
760     s = start;
761     if (isIDFIRST_lazy_if(s,UTF) ||
762         (allow_pack && *s == ':') ||
763         (allow_initial_tick && *s == '\'') )
764     {
765         s = scan_word(s, PL_tokenbuf, sizeof PL_tokenbuf, allow_pack, &len);
766         if (check_keyword && keyword(PL_tokenbuf, len))
767             return start;
768         if (token == METHOD) {
769             s = skipspace(s);
770             if (*s == '(')
771                 PL_expect = XTERM;
772             else {
773                 PL_expect = XOPERATOR;
774             }
775         }
776         PL_nextval[PL_nexttoke].opval = (OP*)newSVOP(OP_CONST,0, newSVpv(PL_tokenbuf,0));
777         PL_nextval[PL_nexttoke].opval->op_private |= OPpCONST_BARE;
778         force_next(token);
779     }
780     return s;
781 }
782
783 /*
784  * S_force_ident
785  * Called when the lexer wants $foo *foo &foo etc, but the program
786  * text only contains the "foo" portion.  The first argument is a pointer
787  * to the "foo", and the second argument is the type symbol to prefix.
788  * Forces the next token to be a "WORD".
789  * Creates the symbol if it didn't already exist (via gv_fetchpv()).
790  */
791
792 STATIC void
793 S_force_ident(pTHX_ register char *s, int kind)
794 {
795     if (s && *s) {
796         OP* o = (OP*)newSVOP(OP_CONST, 0, newSVpv(s,0));
797         PL_nextval[PL_nexttoke].opval = o;
798         force_next(WORD);
799         if (kind) {
800             dTHR;               /* just for in_eval */
801             o->op_private = OPpCONST_ENTERED;
802             /* XXX see note in pp_entereval() for why we forgo typo
803                warnings if the symbol must be introduced in an eval.
804                GSAR 96-10-12 */
805             gv_fetchpv(s, PL_in_eval ? (GV_ADDMULTI | GV_ADDINEVAL) : TRUE,
806                 kind == '$' ? SVt_PV :
807                 kind == '@' ? SVt_PVAV :
808                 kind == '%' ? SVt_PVHV :
809                               SVt_PVGV
810                 );
811         }
812     }
813 }
814
815 NV
816 Perl_str_to_version(pTHX_ SV *sv)
817 {
818     NV retval = 0.0;
819     NV nshift = 1.0;
820     STRLEN len;
821     char *start = SvPVx(sv,len);
822     bool utf = SvUTF8(sv);
823     char *end = start + len;
824     while (start < end) {
825         I32 skip;
826         UV n;
827         if (utf)
828             n = utf8_to_uv((U8*)start, &skip);
829         else {
830             n = *(U8*)start;
831             skip = 1;
832         }
833         retval += ((NV)n)/nshift;
834         start += skip;
835         nshift *= 1000;
836     }
837     return retval;
838 }
839
840 /* 
841  * S_force_version
842  * Forces the next token to be a version number.
843  */
844
845 STATIC char *
846 S_force_version(pTHX_ char *s)
847 {
848     OP *version = Nullop;
849     char *d;
850
851     s = skipspace(s);
852
853     d = s;
854     if (*d == 'v')
855         d++;
856     if (isDIGIT(*d)) {
857         for (; isDIGIT(*d) || *d == '_' || *d == '.'; d++);
858         if (*d == ';' || isSPACE(*d) || *d == '}' || !*d) {
859             SV *ver;
860             s = scan_num(s);
861             version = yylval.opval;
862             ver = cSVOPx(version)->op_sv;
863             if (SvPOK(ver) && !SvNIOK(ver)) {
864                 (void)SvUPGRADE(ver, SVt_PVNV);
865                 SvNVX(ver) = str_to_version(ver);
866                 SvNOK_on(ver);          /* hint that it is a version */
867             }
868         }
869     }
870
871     /* NOTE: The parser sees the package name and the VERSION swapped */
872     PL_nextval[PL_nexttoke].opval = version;
873     force_next(WORD); 
874
875     return (s);
876 }
877
878 /*
879  * S_tokeq
880  * Tokenize a quoted string passed in as an SV.  It finds the next
881  * chunk, up to end of string or a backslash.  It may make a new
882  * SV containing that chunk (if HINT_NEW_STRING is on).  It also
883  * turns \\ into \.
884  */
885
886 STATIC SV *
887 S_tokeq(pTHX_ SV *sv)
888 {
889     register char *s;
890     register char *send;
891     register char *d;
892     STRLEN len = 0;
893     SV *pv = sv;
894
895     if (!SvLEN(sv))
896         goto finish;
897
898     s = SvPV_force(sv, len);
899     if (SvIVX(sv) == -1)
900         goto finish;
901     send = s + len;
902     while (s < send && *s != '\\')
903         s++;
904     if (s == send)
905         goto finish;
906     d = s;
907     if ( PL_hints & HINT_NEW_STRING )
908         pv = sv_2mortal(newSVpvn(SvPVX(pv), len));
909     while (s < send) {
910         if (*s == '\\') {
911             if (s + 1 < send && (s[1] == '\\'))
912                 s++;            /* all that, just for this */
913         }
914         *d++ = *s++;
915     }
916     *d = '\0';
917     SvCUR_set(sv, d - SvPVX(sv));
918   finish:
919     if ( PL_hints & HINT_NEW_STRING )
920        return new_constant(NULL, 0, "q", sv, pv, "q");
921     return sv;
922 }
923
924 /*
925  * Now come three functions related to double-quote context,
926  * S_sublex_start, S_sublex_push, and S_sublex_done.  They're used when
927  * converting things like "\u\Lgnat" into ucfirst(lc("gnat")).  They
928  * interact with PL_lex_state, and create fake ( ... ) argument lists
929  * to handle functions and concatenation.
930  * They assume that whoever calls them will be setting up a fake
931  * join call, because each subthing puts a ',' after it.  This lets
932  *   "lower \luPpEr"
933  * become
934  *  join($, , 'lower ', lcfirst( 'uPpEr', ) ,)
935  *
936  * (I'm not sure whether the spurious commas at the end of lcfirst's
937  * arguments and join's arguments are created or not).
938  */
939
940 /*
941  * S_sublex_start
942  * Assumes that yylval.ival is the op we're creating (e.g. OP_LCFIRST).
943  *
944  * Pattern matching will set PL_lex_op to the pattern-matching op to
945  * make (we return THING if yylval.ival is OP_NULL, PMFUNC otherwise).
946  *
947  * OP_CONST and OP_READLINE are easy--just make the new op and return.
948  *
949  * Everything else becomes a FUNC.
950  *
951  * Sets PL_lex_state to LEX_INTERPPUSH unless (ival was OP_NULL or we
952  * had an OP_CONST or OP_READLINE).  This just sets us up for a
953  * call to S_sublex_push().
954  */
955
956 STATIC I32
957 S_sublex_start(pTHX)
958 {
959     register I32 op_type = yylval.ival;
960
961     if (op_type == OP_NULL) {
962         yylval.opval = PL_lex_op;
963         PL_lex_op = Nullop;
964         return THING;
965     }
966     if (op_type == OP_CONST || op_type == OP_READLINE) {
967         SV *sv = tokeq(PL_lex_stuff);
968
969         if (SvTYPE(sv) == SVt_PVIV) {
970             /* Overloaded constants, nothing fancy: Convert to SVt_PV: */
971             STRLEN len;
972             char *p;
973             SV *nsv;
974
975             p = SvPV(sv, len);
976             nsv = newSVpvn(p, len);
977             SvREFCNT_dec(sv);
978             sv = nsv;
979         } 
980         yylval.opval = (OP*)newSVOP(op_type, 0, sv);
981         PL_lex_stuff = Nullsv;
982         return THING;
983     }
984
985     PL_sublex_info.super_state = PL_lex_state;
986     PL_sublex_info.sub_inwhat = op_type;
987     PL_sublex_info.sub_op = PL_lex_op;
988     PL_lex_state = LEX_INTERPPUSH;
989
990     PL_expect = XTERM;
991     if (PL_lex_op) {
992         yylval.opval = PL_lex_op;
993         PL_lex_op = Nullop;
994         return PMFUNC;
995     }
996     else
997         return FUNC;
998 }
999
1000 /*
1001  * S_sublex_push
1002  * Create a new scope to save the lexing state.  The scope will be
1003  * ended in S_sublex_done.  Returns a '(', starting the function arguments
1004  * to the uc, lc, etc. found before.
1005  * Sets PL_lex_state to LEX_INTERPCONCAT.
1006  */
1007
1008 STATIC I32
1009 S_sublex_push(pTHX)
1010 {
1011     dTHR;
1012     ENTER;
1013
1014     PL_lex_state = PL_sublex_info.super_state;
1015     SAVEI32(PL_lex_dojoin);
1016     SAVEI32(PL_lex_brackets);
1017     SAVEI32(PL_lex_casemods);
1018     SAVEI32(PL_lex_starts);
1019     SAVEI32(PL_lex_state);
1020     SAVEVPTR(PL_lex_inpat);
1021     SAVEI32(PL_lex_inwhat);
1022     SAVECOPLINE(PL_curcop);
1023     SAVEPPTR(PL_bufptr);
1024     SAVEPPTR(PL_oldbufptr);
1025     SAVEPPTR(PL_oldoldbufptr);
1026     SAVEPPTR(PL_linestart);
1027     SAVESPTR(PL_linestr);
1028     SAVEPPTR(PL_lex_brackstack);
1029     SAVEPPTR(PL_lex_casestack);
1030
1031     PL_linestr = PL_lex_stuff;
1032     PL_lex_stuff = Nullsv;
1033
1034     PL_bufend = PL_bufptr = PL_oldbufptr = PL_oldoldbufptr = PL_linestart
1035         = SvPVX(PL_linestr);
1036     PL_bufend += SvCUR(PL_linestr);
1037     SAVEFREESV(PL_linestr);
1038
1039     PL_lex_dojoin = FALSE;
1040     PL_lex_brackets = 0;
1041     New(899, PL_lex_brackstack, 120, char);
1042     New(899, PL_lex_casestack, 12, char);
1043     SAVEFREEPV(PL_lex_brackstack);
1044     SAVEFREEPV(PL_lex_casestack);
1045     PL_lex_casemods = 0;
1046     *PL_lex_casestack = '\0';
1047     PL_lex_starts = 0;
1048     PL_lex_state = LEX_INTERPCONCAT;
1049     CopLINE_set(PL_curcop, PL_multi_start);
1050
1051     PL_lex_inwhat = PL_sublex_info.sub_inwhat;
1052     if (PL_lex_inwhat == OP_MATCH || PL_lex_inwhat == OP_QR || PL_lex_inwhat == OP_SUBST)
1053         PL_lex_inpat = PL_sublex_info.sub_op;
1054     else
1055         PL_lex_inpat = Nullop;
1056
1057     return '(';
1058 }
1059
1060 /*
1061  * S_sublex_done
1062  * Restores lexer state after a S_sublex_push.
1063  */
1064
1065 STATIC I32
1066 S_sublex_done(pTHX)
1067 {
1068     if (!PL_lex_starts++) {
1069         PL_expect = XOPERATOR;
1070         yylval.opval = (OP*)newSVOP(OP_CONST, 0, newSVpvn("",0));
1071         return THING;
1072     }
1073
1074     if (PL_lex_casemods) {              /* oops, we've got some unbalanced parens */
1075         PL_lex_state = LEX_INTERPCASEMOD;
1076         return yylex();
1077     }
1078
1079     /* Is there a right-hand side to take care of? (s//RHS/ or tr//RHS/) */
1080     if (PL_lex_repl && (PL_lex_inwhat == OP_SUBST || PL_lex_inwhat == OP_TRANS)) {
1081         PL_linestr = PL_lex_repl;
1082         PL_lex_inpat = 0;
1083         PL_bufend = PL_bufptr = PL_oldbufptr = PL_oldoldbufptr = PL_linestart = SvPVX(PL_linestr);
1084         PL_bufend += SvCUR(PL_linestr);
1085         SAVEFREESV(PL_linestr);
1086         PL_lex_dojoin = FALSE;
1087         PL_lex_brackets = 0;
1088         PL_lex_casemods = 0;
1089         *PL_lex_casestack = '\0';
1090         PL_lex_starts = 0;
1091         if (SvEVALED(PL_lex_repl)) {
1092             PL_lex_state = LEX_INTERPNORMAL;
1093             PL_lex_starts++;
1094             /*  we don't clear PL_lex_repl here, so that we can check later
1095                 whether this is an evalled subst; that means we rely on the
1096                 logic to ensure sublex_done() is called again only via the
1097                 branch (in yylex()) that clears PL_lex_repl, else we'll loop */
1098         }
1099         else {
1100             PL_lex_state = LEX_INTERPCONCAT;
1101             PL_lex_repl = Nullsv;
1102         }
1103         return ',';
1104     }
1105     else {
1106         LEAVE;
1107         PL_bufend = SvPVX(PL_linestr);
1108         PL_bufend += SvCUR(PL_linestr);
1109         PL_expect = XOPERATOR;
1110         PL_sublex_info.sub_inwhat = 0;
1111         return ')';
1112     }
1113 }
1114
1115 /*
1116   scan_const
1117
1118   Extracts a pattern, double-quoted string, or transliteration.  This
1119   is terrifying code.
1120
1121   It looks at lex_inwhat and PL_lex_inpat to find out whether it's
1122   processing a pattern (PL_lex_inpat is true), a transliteration
1123   (lex_inwhat & OP_TRANS is true), or a double-quoted string.
1124
1125   Returns a pointer to the character scanned up to. Iff this is
1126   advanced from the start pointer supplied (ie if anything was
1127   successfully parsed), will leave an OP for the substring scanned
1128   in yylval. Caller must intuit reason for not parsing further
1129   by looking at the next characters herself.
1130
1131   In patterns:
1132     backslashes:
1133       double-quoted style: \r and \n
1134       regexp special ones: \D \s
1135       constants: \x3
1136       backrefs: \1 (deprecated in substitution replacements)
1137       case and quoting: \U \Q \E
1138     stops on @ and $, but not for $ as tail anchor
1139
1140   In transliterations:
1141     characters are VERY literal, except for - not at the start or end
1142     of the string, which indicates a range.  scan_const expands the
1143     range to the full set of intermediate characters.
1144
1145   In double-quoted strings:
1146     backslashes:
1147       double-quoted style: \r and \n
1148       constants: \x3
1149       backrefs: \1 (deprecated)
1150       case and quoting: \U \Q \E
1151     stops on @ and $
1152
1153   scan_const does *not* construct ops to handle interpolated strings.
1154   It stops processing as soon as it finds an embedded $ or @ variable
1155   and leaves it to the caller to work out what's going on.
1156
1157   @ in pattern could be: @foo, @{foo}, @$foo, @'foo, @:foo.
1158
1159   $ in pattern could be $foo or could be tail anchor.  Assumption:
1160   it's a tail anchor if $ is the last thing in the string, or if it's
1161   followed by one of ")| \n\t"
1162
1163   \1 (backreferences) are turned into $1
1164
1165   The structure of the code is
1166       while (there's a character to process) {
1167           handle transliteration ranges
1168           skip regexp comments
1169           skip # initiated comments in //x patterns
1170           check for embedded @foo
1171           check for embedded scalars
1172           if (backslash) {
1173               leave intact backslashes from leave (below)
1174               deprecate \1 in strings and sub replacements
1175               handle string-changing backslashes \l \U \Q \E, etc.
1176               switch (what was escaped) {
1177                   handle - in a transliteration (becomes a literal -)
1178                   handle \132 octal characters
1179                   handle 0x15 hex characters
1180                   handle \cV (control V)
1181                   handle printf backslashes (\f, \r, \n, etc)
1182               } (end switch)
1183           } (end if backslash)
1184     } (end while character to read)
1185                   
1186 */
1187
1188 STATIC char *
1189 S_scan_const(pTHX_ char *start)
1190 {
1191     register char *send = PL_bufend;            /* end of the constant */
1192     SV *sv = NEWSV(93, send - start);           /* sv for the constant */
1193     register char *s = start;                   /* start of the constant */
1194     register char *d = SvPVX(sv);               /* destination for copies */
1195     bool dorange = FALSE;                       /* are we in a translit range? */
1196     bool has_utf = FALSE;                       /* embedded \x{} */
1197     I32 len;                                    /* ? */
1198     UV uv;
1199
1200     I32 utf = (PL_lex_inwhat == OP_TRANS && PL_sublex_info.sub_op)
1201         ? (PL_sublex_info.sub_op->op_private & (OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF))
1202         : UTF;
1203     I32 thisutf = (PL_lex_inwhat == OP_TRANS && PL_sublex_info.sub_op)
1204         ? (PL_sublex_info.sub_op->op_private & (PL_lex_repl ?
1205                                                 OPpTRANS_FROM_UTF : OPpTRANS_TO_UTF))
1206         : UTF;
1207     const char *leaveit =       /* set of acceptably-backslashed characters */
1208         PL_lex_inpat
1209             ? "\\.^$@AGZdDwWsSbBpPXC+*?|()-nrtfeaxcz0123456789[{]} \t\n\r\f\v#"
1210             : "";
1211
1212     while (s < send || dorange) {
1213         /* get transliterations out of the way (they're most literal) */
1214         if (PL_lex_inwhat == OP_TRANS) {
1215             /* expand a range A-Z to the full set of characters.  AIE! */
1216             if (dorange) {
1217                 I32 i;                          /* current expanded character */
1218                 I32 min;                        /* first character in range */
1219                 I32 max;                        /* last character in range */
1220
1221                 i = d - SvPVX(sv);              /* remember current offset */
1222                 SvGROW(sv, SvLEN(sv) + 256);    /* never more than 256 chars in a range */
1223                 d = SvPVX(sv) + i;              /* refresh d after realloc */
1224                 d -= 2;                         /* eat the first char and the - */
1225
1226                 min = (U8)*d;                   /* first char in range */
1227                 max = (U8)d[1];                 /* last char in range  */
1228
1229 #ifndef ASCIIish
1230                 if ((isLOWER(min) && isLOWER(max)) ||
1231                     (isUPPER(min) && isUPPER(max))) {
1232                     if (isLOWER(min)) {
1233                         for (i = min; i <= max; i++)
1234                             if (isLOWER(i))
1235                                 *d++ = i;
1236                     } else {
1237                         for (i = min; i <= max; i++)
1238                             if (isUPPER(i))
1239                                 *d++ = i;
1240                     }
1241                 }
1242                 else
1243 #endif
1244                     for (i = min; i <= max; i++)
1245                         *d++ = i;
1246
1247                 /* mark the range as done, and continue */
1248                 dorange = FALSE;
1249                 continue;
1250             }
1251
1252             /* range begins (ignore - as first or last char) */
1253             else if (*s == '-' && s+1 < send  && s != start) {
1254                 if (utf) {
1255                     *d++ = (char)0xff;  /* use illegal utf8 byte--see pmtrans */
1256                     s++;
1257                     continue;
1258                 }
1259                 dorange = TRUE;
1260                 s++;
1261             }
1262         }
1263
1264         /* if we get here, we're not doing a transliteration */
1265
1266         /* skip for regexp comments /(?#comment)/ and code /(?{code})/,
1267            except for the last char, which will be done separately. */
1268         else if (*s == '(' && PL_lex_inpat && s[1] == '?') {
1269             if (s[2] == '#') {
1270                 while (s < send && *s != ')')
1271                     *d++ = *s++;
1272             }
1273             else if (s[2] == '{' /* This should match regcomp.c */
1274                      || ((s[2] == 'p' || s[2] == '?') && s[3] == '{'))
1275             {
1276                 I32 count = 1;
1277                 char *regparse = s + (s[2] == '{' ? 3 : 4);
1278                 char c;
1279
1280                 while (count && (c = *regparse)) {
1281                     if (c == '\\' && regparse[1])
1282                         regparse++;
1283                     else if (c == '{') 
1284                         count++;
1285                     else if (c == '}') 
1286                         count--;
1287                     regparse++;
1288                 }
1289                 if (*regparse != ')') {
1290                     regparse--;         /* Leave one char for continuation. */
1291                     yyerror("Sequence (?{...}) not terminated or not {}-balanced");
1292                 }
1293                 while (s < regparse)
1294                     *d++ = *s++;
1295             }
1296         }
1297
1298         /* likewise skip #-initiated comments in //x patterns */
1299         else if (*s == '#' && PL_lex_inpat &&
1300           ((PMOP*)PL_lex_inpat)->op_pmflags & PMf_EXTENDED) {
1301             while (s+1 < send && *s != '\n')
1302                 *d++ = *s++;
1303         }
1304
1305         /* check for embedded arrays (@foo, @:foo, @'foo, @{foo}, @$foo) */
1306         else if (*s == '@' && s[1]
1307                  && (isALNUM_lazy_if(s+1,UTF) || strchr(":'{$", s[1])))
1308             break;
1309
1310         /* check for embedded scalars.  only stop if we're sure it's a
1311            variable.
1312         */
1313         else if (*s == '$') {
1314             if (!PL_lex_inpat)  /* not a regexp, so $ must be var */
1315                 break;
1316             if (s + 1 < send && !strchr("()| \n\t", s[1]))
1317                 break;          /* in regexp, $ might be tail anchor */
1318         }
1319
1320         /* (now in tr/// code again) */
1321
1322         if (*s & 0x80 && thisutf) {
1323            (void)utf8_to_uv((U8*)s, &len);
1324            if (len == 1) {
1325                /* illegal UTF8, make it valid */
1326                char *old_pvx = SvPVX(sv);
1327                /* need space for one extra char (NOTE: SvCUR() not set here) */
1328                d = SvGROW(sv, SvLEN(sv) + 1) + (d - old_pvx);
1329                d = (char*)uv_to_utf8((U8*)d, (U8)*s++);
1330            }
1331            else {
1332                while (len--)
1333                    *d++ = *s++;
1334            }
1335            has_utf = TRUE;
1336            continue;
1337         }
1338
1339         /* backslashes */
1340         if (*s == '\\' && s+1 < send) {
1341             s++;
1342
1343             /* some backslashes we leave behind */
1344             if (*leaveit && *s && strchr(leaveit, *s)) {
1345                 *d++ = '\\';
1346                 *d++ = *s++;
1347                 continue;
1348             }
1349
1350             /* deprecate \1 in strings and substitution replacements */
1351             if (PL_lex_inwhat == OP_SUBST && !PL_lex_inpat &&
1352                 isDIGIT(*s) && *s != '0' && !isDIGIT(s[1]))
1353             {
1354                 dTHR;                   /* only for ckWARN */
1355                 if (ckWARN(WARN_SYNTAX))
1356                     Perl_warner(aTHX_ WARN_SYNTAX, "\\%c better written as $%c", *s, *s);
1357                 *--s = '$';
1358                 break;
1359             }
1360
1361             /* string-change backslash escapes */
1362             if (PL_lex_inwhat != OP_TRANS && *s && strchr("lLuUEQ", *s)) {
1363                 --s;
1364                 break;
1365             }
1366
1367             /* if we get here, it's either a quoted -, or a digit */
1368             switch (*s) {
1369
1370             /* quoted - in transliterations */
1371             case '-':
1372                 if (PL_lex_inwhat == OP_TRANS) {
1373                     *d++ = *s++;
1374                     continue;
1375                 }
1376                 /* FALL THROUGH */
1377             default:
1378                 {
1379                     dTHR;
1380                     if (ckWARN(WARN_MISC) && isALPHA(*s))
1381                         Perl_warner(aTHX_ WARN_MISC, 
1382                                "Unrecognized escape \\%c passed through",
1383                                *s);
1384                     /* default action is to copy the quoted character */
1385                     *d++ = *s++;
1386                     continue;
1387                 }
1388
1389             /* \132 indicates an octal constant */
1390             case '0': case '1': case '2': case '3':
1391             case '4': case '5': case '6': case '7':
1392                 uv = (UV)scan_oct(s, 3, &len);
1393                 s += len;
1394                 goto NUM_ESCAPE_INSERT;
1395
1396             /* \x24 indicates a hex constant */
1397             case 'x':
1398                 ++s;
1399                 if (*s == '{') {
1400                     char* e = strchr(s, '}');
1401                     if (!e) {
1402                         yyerror("Missing right brace on \\x{}");
1403                         e = s;
1404                     }
1405                     uv = (UV)scan_hex(s + 1, e - s - 1, &len);
1406                     s = e + 1;
1407                 }
1408                 else {
1409                     uv = (UV)scan_hex(s, 2, &len);
1410                     s += len;
1411                 }
1412
1413               NUM_ESCAPE_INSERT:
1414                 /* Insert oct or hex escaped character.
1415                  * There will always enough room in sv since such escapes will
1416                  * be longer than any utf8 sequence they can end up as
1417                  */
1418                 if (uv > 127) {
1419                     if (!thisutf && !has_utf && uv > 255) {
1420                         /* might need to recode whatever we have accumulated so far
1421                          * if it contains any hibit chars
1422                          */
1423                         int hicount = 0;
1424                         char *c;
1425                         for (c = SvPVX(sv); c < d; c++) {
1426                             if (*c & 0x80)
1427                                 hicount++;
1428                         }
1429                         if (hicount) {
1430                             char *old_pvx = SvPVX(sv);
1431                             char *src, *dst;
1432                             d = SvGROW(sv, SvCUR(sv) + hicount + 1) + (d - old_pvx);
1433
1434                             src = d - 1;
1435                             d += hicount;
1436                             dst = d - 1;
1437
1438                             while (src < dst) {
1439                                 if (*src & 0x80) {
1440                                     dst--;
1441                                     uv_to_utf8((U8*)dst, (U8)*src--);
1442                                     dst--;
1443                                 }
1444                                 else {
1445                                     *dst-- = *src--;
1446                                 }
1447                             }
1448                         }
1449                     }
1450
1451                     if (thisutf || uv > 255) {
1452                         d = (char*)uv_to_utf8((U8*)d, uv);
1453                         has_utf = TRUE;
1454                     }
1455                     else {
1456                         *d++ = (char)uv;
1457                     }
1458                 }
1459                 else {
1460                     *d++ = (char)uv;
1461                 }
1462                 continue;
1463
1464             /* \N{latin small letter a} is a named character */
1465             case 'N':
1466                 ++s;
1467                 if (*s == '{') {
1468                     char* e = strchr(s, '}');
1469                     SV *res;
1470                     STRLEN len;
1471                     char *str;
1472  
1473                     if (!e) {
1474                         yyerror("Missing right brace on \\N{}");
1475                         e = s - 1;
1476                         goto cont_scan;
1477                     }
1478                     res = newSVpvn(s + 1, e - s - 1);
1479                     res = new_constant( Nullch, 0, "charnames", 
1480                                         res, Nullsv, "\\N{...}" );
1481                     str = SvPV(res,len);
1482                     if (len > 1)
1483                         has_utf = TRUE;
1484                     if (len > e - s + 4) {
1485                         char *odest = SvPVX(sv);
1486
1487                         SvGROW(sv, (SvCUR(sv) + len - (e - s + 4)));
1488                         d = SvPVX(sv) + (d - odest);
1489                     }
1490                     Copy(str, d, len, char);
1491                     d += len;
1492                     SvREFCNT_dec(res);
1493                   cont_scan:
1494                     s = e + 1;
1495                 }
1496                 else
1497                     yyerror("Missing braces on \\N{}");
1498                 continue;
1499
1500             /* \c is a control character */
1501             case 'c':
1502                 s++;
1503 #ifdef EBCDIC
1504                 *d = *s++;
1505                 if (isLOWER(*d))
1506                    *d = toUPPER(*d);
1507                 *d++ = toCTRL(*d); 
1508 #else
1509                 len = *s++;
1510                 *d++ = toCTRL(len);
1511 #endif
1512                 continue;
1513
1514             /* printf-style backslashes, formfeeds, newlines, etc */
1515             case 'b':
1516                 *d++ = '\b';
1517                 break;
1518             case 'n':
1519                 *d++ = '\n';
1520                 break;
1521             case 'r':
1522                 *d++ = '\r';
1523                 break;
1524             case 'f':
1525                 *d++ = '\f';
1526                 break;
1527             case 't':
1528                 *d++ = '\t';
1529                 break;
1530 #ifdef EBCDIC
1531             case 'e':
1532                 *d++ = '\047';  /* CP 1047 */
1533                 break;
1534             case 'a':
1535                 *d++ = '\057';  /* CP 1047 */
1536                 break;
1537 #else
1538             case 'e':
1539                 *d++ = '\033';
1540                 break;
1541             case 'a':
1542                 *d++ = '\007';
1543                 break;
1544 #endif
1545             } /* end switch */
1546
1547             s++;
1548             continue;
1549         } /* end if (backslash) */
1550
1551         *d++ = *s++;
1552     } /* while loop to process each character */
1553
1554     /* terminate the string and set up the sv */
1555     *d = '\0';
1556     SvCUR_set(sv, d - SvPVX(sv));
1557     SvPOK_on(sv);
1558     if (has_utf)
1559         SvUTF8_on(sv);
1560
1561     /* shrink the sv if we allocated more than we used */
1562     if (SvCUR(sv) + 5 < SvLEN(sv)) {
1563         SvLEN_set(sv, SvCUR(sv) + 1);
1564         Renew(SvPVX(sv), SvLEN(sv), char);
1565     }
1566
1567     /* return the substring (via yylval) only if we parsed anything */
1568     if (s > PL_bufptr) {
1569         if ( PL_hints & ( PL_lex_inpat ? HINT_NEW_RE : HINT_NEW_STRING ) )
1570             sv = new_constant(start, s - start, (PL_lex_inpat ? "qr" : "q"), 
1571                               sv, Nullsv,
1572                               ( PL_lex_inwhat == OP_TRANS 
1573                                 ? "tr"
1574                                 : ( (PL_lex_inwhat == OP_SUBST && !PL_lex_inpat)
1575                                     ? "s"
1576                                     : "qq")));
1577         yylval.opval = (OP*)newSVOP(OP_CONST, 0, sv);
1578     } else
1579         SvREFCNT_dec(sv);
1580     return s;
1581 }
1582
1583 /* S_intuit_more
1584  * Returns TRUE if there's more to the expression (e.g., a subscript),
1585  * FALSE otherwise.
1586  *
1587  * It deals with "$foo[3]" and /$foo[3]/ and /$foo[0123456789$]+/
1588  *
1589  * ->[ and ->{ return TRUE
1590  * { and [ outside a pattern are always subscripts, so return TRUE
1591  * if we're outside a pattern and it's not { or [, then return FALSE
1592  * if we're in a pattern and the first char is a {
1593  *   {4,5} (any digits around the comma) returns FALSE
1594  * if we're in a pattern and the first char is a [
1595  *   [] returns FALSE
1596  *   [SOMETHING] has a funky algorithm to decide whether it's a
1597  *      character class or not.  It has to deal with things like
1598  *      /$foo[-3]/ and /$foo[$bar]/ as well as /$foo[$\d]+/
1599  * anything else returns TRUE
1600  */
1601
1602 /* This is the one truly awful dwimmer necessary to conflate C and sed. */
1603
1604 STATIC int
1605 S_intuit_more(pTHX_ register char *s)
1606 {
1607     if (PL_lex_brackets)
1608         return TRUE;
1609     if (*s == '-' && s[1] == '>' && (s[2] == '[' || s[2] == '{'))
1610         return TRUE;
1611     if (*s != '{' && *s != '[')
1612         return FALSE;
1613     if (!PL_lex_inpat)
1614         return TRUE;
1615
1616     /* In a pattern, so maybe we have {n,m}. */
1617     if (*s == '{') {
1618         s++;
1619         if (!isDIGIT(*s))
1620             return TRUE;
1621         while (isDIGIT(*s))
1622             s++;
1623         if (*s == ',')
1624             s++;
1625         while (isDIGIT(*s))
1626             s++;
1627         if (*s == '}')
1628             return FALSE;
1629         return TRUE;
1630         
1631     }
1632
1633     /* On the other hand, maybe we have a character class */
1634
1635     s++;
1636     if (*s == ']' || *s == '^')
1637         return FALSE;
1638     else {
1639         /* this is terrifying, and it works */
1640         int weight = 2;         /* let's weigh the evidence */
1641         char seen[256];
1642         unsigned char un_char = 255, last_un_char;
1643         char *send = strchr(s,']');
1644         char tmpbuf[sizeof PL_tokenbuf * 4];
1645
1646         if (!send)              /* has to be an expression */
1647             return TRUE;
1648
1649         Zero(seen,256,char);
1650         if (*s == '$')
1651             weight -= 3;
1652         else if (isDIGIT(*s)) {
1653             if (s[1] != ']') {
1654                 if (isDIGIT(s[1]) && s[2] == ']')
1655                     weight -= 10;
1656             }
1657             else
1658                 weight -= 100;
1659         }
1660         for (; s < send; s++) {
1661             last_un_char = un_char;
1662             un_char = (unsigned char)*s;
1663             switch (*s) {
1664             case '@':
1665             case '&':
1666             case '$':
1667                 weight -= seen[un_char] * 10;
1668                 if (isALNUM_lazy_if(s+1,UTF)) {
1669                     scan_ident(s, send, tmpbuf, sizeof tmpbuf, FALSE);
1670                     if ((int)strlen(tmpbuf) > 1 && gv_fetchpv(tmpbuf,FALSE, SVt_PV))
1671                         weight -= 100;
1672                     else
1673                         weight -= 10;
1674                 }
1675                 else if (*s == '$' && s[1] &&
1676                   strchr("[#!%*<>()-=",s[1])) {
1677                     if (/*{*/ strchr("])} =",s[2]))
1678                         weight -= 10;
1679                     else
1680                         weight -= 1;
1681                 }
1682                 break;
1683             case '\\':
1684                 un_char = 254;
1685                 if (s[1]) {
1686                     if (strchr("wds]",s[1]))
1687                         weight += 100;
1688                     else if (seen['\''] || seen['"'])
1689                         weight += 1;
1690                     else if (strchr("rnftbxcav",s[1]))
1691                         weight += 40;
1692                     else if (isDIGIT(s[1])) {
1693                         weight += 40;
1694                         while (s[1] && isDIGIT(s[1]))
1695                             s++;
1696                     }
1697                 }
1698                 else
1699                     weight += 100;
1700                 break;
1701             case '-':
1702                 if (s[1] == '\\')
1703                     weight += 50;
1704                 if (strchr("aA01! ",last_un_char))
1705                     weight += 30;
1706                 if (strchr("zZ79~",s[1]))
1707                     weight += 30;
1708                 if (last_un_char == 255 && (isDIGIT(s[1]) || s[1] == '$'))
1709                     weight -= 5;        /* cope with negative subscript */
1710                 break;
1711             default:
1712                 if (!isALNUM(last_un_char) && !strchr("$@&",last_un_char) &&
1713                         isALPHA(*s) && s[1] && isALPHA(s[1])) {
1714                     char *d = tmpbuf;
1715                     while (isALPHA(*s))
1716                         *d++ = *s++;
1717                     *d = '\0';
1718                     if (keyword(tmpbuf, d - tmpbuf))
1719                         weight -= 150;
1720                 }
1721                 if (un_char == last_un_char + 1)
1722                     weight += 5;
1723                 weight -= seen[un_char];
1724                 break;
1725             }
1726             seen[un_char]++;
1727         }
1728         if (weight >= 0)        /* probably a character class */
1729             return FALSE;
1730     }
1731
1732     return TRUE;
1733 }
1734
1735 /*
1736  * S_intuit_method
1737  *
1738  * Does all the checking to disambiguate
1739  *   foo bar
1740  * between foo(bar) and bar->foo.  Returns 0 if not a method, otherwise
1741  * FUNCMETH (bar->foo(args)) or METHOD (bar->foo args).
1742  *
1743  * First argument is the stuff after the first token, e.g. "bar".
1744  *
1745  * Not a method if bar is a filehandle.
1746  * Not a method if foo is a subroutine prototyped to take a filehandle.
1747  * Not a method if it's really "Foo $bar"
1748  * Method if it's "foo $bar"
1749  * Not a method if it's really "print foo $bar"
1750  * Method if it's really "foo package::" (interpreted as package->foo)
1751  * Not a method if bar is known to be a subroutne ("sub bar; foo bar")
1752  * Not a method if bar is a filehandle or package, but is quoted with
1753  *   =>
1754  */
1755
1756 STATIC int
1757 S_intuit_method(pTHX_ char *start, GV *gv)
1758 {
1759     char *s = start + (*start == '$');
1760     char tmpbuf[sizeof PL_tokenbuf];
1761     STRLEN len;
1762     GV* indirgv;
1763
1764     if (gv) {
1765         CV *cv;
1766         if (GvIO(gv))
1767             return 0;
1768         if ((cv = GvCVu(gv))) {
1769             char *proto = SvPVX(cv);
1770             if (proto) {
1771                 if (*proto == ';')
1772                     proto++;
1773                 if (*proto == '*')
1774                     return 0;
1775             }
1776         } else
1777             gv = 0;
1778     }
1779     s = scan_word(s, tmpbuf, sizeof tmpbuf, TRUE, &len);
1780     /* start is the beginning of the possible filehandle/object,
1781      * and s is the end of it
1782      * tmpbuf is a copy of it
1783      */
1784
1785     if (*start == '$') {
1786         if (gv || PL_last_lop_op == OP_PRINT || isUPPER(*PL_tokenbuf))
1787             return 0;
1788         s = skipspace(s);
1789         PL_bufptr = start;
1790         PL_expect = XREF;
1791         return *s == '(' ? FUNCMETH : METHOD;
1792     }
1793     if (!keyword(tmpbuf, len)) {
1794         if (len > 2 && tmpbuf[len - 2] == ':' && tmpbuf[len - 1] == ':') {
1795             len -= 2;
1796             tmpbuf[len] = '\0';
1797             goto bare_package;
1798         }
1799         indirgv = gv_fetchpv(tmpbuf, FALSE, SVt_PVCV);
1800         if (indirgv && GvCVu(indirgv))
1801             return 0;
1802         /* filehandle or package name makes it a method */
1803         if (!gv || GvIO(indirgv) || gv_stashpvn(tmpbuf, len, FALSE)) {
1804             s = skipspace(s);
1805             if ((PL_bufend - s) >= 2 && *s == '=' && *(s+1) == '>')
1806                 return 0;       /* no assumptions -- "=>" quotes bearword */
1807       bare_package:
1808             PL_nextval[PL_nexttoke].opval = (OP*)newSVOP(OP_CONST, 0,
1809                                                    newSVpvn(tmpbuf,len));
1810             PL_nextval[PL_nexttoke].opval->op_private = OPpCONST_BARE;
1811             PL_expect = XTERM;
1812             force_next(WORD);
1813             PL_bufptr = s;
1814             return *s == '(' ? FUNCMETH : METHOD;
1815         }
1816     }
1817     return 0;
1818 }
1819
1820 /*
1821  * S_incl_perldb
1822  * Return a string of Perl code to load the debugger.  If PERL5DB
1823  * is set, it will return the contents of that, otherwise a
1824  * compile-time require of perl5db.pl.
1825  */
1826
1827 STATIC char*
1828 S_incl_perldb(pTHX)
1829 {
1830     if (PL_perldb) {
1831         char *pdb = PerlEnv_getenv("PERL5DB");
1832
1833         if (pdb)
1834             return pdb;
1835         SETERRNO(0,SS$_NORMAL);
1836         return "BEGIN { require 'perl5db.pl' }";
1837     }
1838     return "";
1839 }
1840
1841
1842 /* Encoded script support. filter_add() effectively inserts a
1843  * 'pre-processing' function into the current source input stream. 
1844  * Note that the filter function only applies to the current source file
1845  * (e.g., it will not affect files 'require'd or 'use'd by this one).
1846  *
1847  * The datasv parameter (which may be NULL) can be used to pass
1848  * private data to this instance of the filter. The filter function
1849  * can recover the SV using the FILTER_DATA macro and use it to
1850  * store private buffers and state information.
1851  *
1852  * The supplied datasv parameter is upgraded to a PVIO type
1853  * and the IoDIRP field is used to store the function pointer,
1854  * and IOf_FAKE_DIRP is enabled on datasv to mark this as such.
1855  * Note that IoTOP_NAME, IoFMT_NAME, IoBOTTOM_NAME, if set for
1856  * private use must be set using malloc'd pointers.
1857  */
1858
1859 SV *
1860 Perl_filter_add(pTHX_ filter_t funcp, SV *datasv)
1861 {
1862     if (!funcp)
1863         return Nullsv;
1864
1865     if (!PL_rsfp_filters)
1866         PL_rsfp_filters = newAV();
1867     if (!datasv)
1868         datasv = NEWSV(255,0);
1869     if (!SvUPGRADE(datasv, SVt_PVIO))
1870         Perl_die(aTHX_ "Can't upgrade filter_add data to SVt_PVIO");
1871     IoDIRP(datasv) = (DIR*)funcp; /* stash funcp into spare field */
1872     IoFLAGS(datasv) |= IOf_FAKE_DIRP;
1873     DEBUG_P(PerlIO_printf(Perl_debug_log, "filter_add func %p (%s)\n",
1874                           funcp, SvPV_nolen(datasv)));
1875     av_unshift(PL_rsfp_filters, 1);
1876     av_store(PL_rsfp_filters, 0, datasv) ;
1877     return(datasv);
1878 }
1879  
1880
1881 /* Delete most recently added instance of this filter function. */
1882 void
1883 Perl_filter_del(pTHX_ filter_t funcp)
1884 {
1885     SV *datasv;
1886     DEBUG_P(PerlIO_printf(Perl_debug_log, "filter_del func %p", funcp));
1887     if (!PL_rsfp_filters || AvFILLp(PL_rsfp_filters)<0)
1888         return;
1889     /* if filter is on top of stack (usual case) just pop it off */
1890     datasv = FILTER_DATA(AvFILLp(PL_rsfp_filters));
1891     if (IoDIRP(datasv) == (DIR*)funcp) {
1892         IoFLAGS(datasv) &= ~IOf_FAKE_DIRP;
1893         IoDIRP(datasv) = (DIR*)NULL;
1894         sv_free(av_pop(PL_rsfp_filters));
1895
1896         return;
1897     }
1898     /* we need to search for the correct entry and clear it     */
1899     Perl_die(aTHX_ "filter_del can only delete in reverse order (currently)");
1900 }
1901
1902
1903 /* Invoke the n'th filter function for the current rsfp.         */
1904 I32
1905 Perl_filter_read(pTHX_ int idx, SV *buf_sv, int maxlen)
1906             
1907                
1908                         /* 0 = read one text line */
1909 {
1910     filter_t funcp;
1911     SV *datasv = NULL;
1912
1913     if (!PL_rsfp_filters)
1914         return -1;
1915     if (idx > AvFILLp(PL_rsfp_filters)){       /* Any more filters?     */
1916         /* Provide a default input filter to make life easy.    */
1917         /* Note that we append to the line. This is handy.      */
1918         DEBUG_P(PerlIO_printf(Perl_debug_log,
1919                               "filter_read %d: from rsfp\n", idx));
1920         if (maxlen) { 
1921             /* Want a block */
1922             int len ;
1923             int old_len = SvCUR(buf_sv) ;
1924
1925             /* ensure buf_sv is large enough */
1926             SvGROW(buf_sv, old_len + maxlen) ;
1927             if ((len = PerlIO_read(PL_rsfp, SvPVX(buf_sv) + old_len, maxlen)) <= 0){
1928                 if (PerlIO_error(PL_rsfp))
1929                     return -1;          /* error */
1930                 else
1931                     return 0 ;          /* end of file */
1932             }
1933             SvCUR_set(buf_sv, old_len + len) ;
1934         } else {
1935             /* Want a line */
1936             if (sv_gets(buf_sv, PL_rsfp, SvCUR(buf_sv)) == NULL) {
1937                 if (PerlIO_error(PL_rsfp))
1938                     return -1;          /* error */
1939                 else
1940                     return 0 ;          /* end of file */
1941             }
1942         }
1943         return SvCUR(buf_sv);
1944     }
1945     /* Skip this filter slot if filter has been deleted */
1946     if ( (datasv = FILTER_DATA(idx)) == &PL_sv_undef){
1947         DEBUG_P(PerlIO_printf(Perl_debug_log,
1948                               "filter_read %d: skipped (filter deleted)\n",
1949                               idx));
1950         return FILTER_READ(idx+1, buf_sv, maxlen); /* recurse */
1951     }
1952     /* Get function pointer hidden within datasv        */
1953     funcp = (filter_t)IoDIRP(datasv);
1954     DEBUG_P(PerlIO_printf(Perl_debug_log,
1955                           "filter_read %d: via function %p (%s)\n",
1956                           idx, funcp, SvPV_nolen(datasv)));
1957     /* Call function. The function is expected to       */
1958     /* call "FILTER_READ(idx+1, buf_sv)" first.         */
1959     /* Return: <0:error, =0:eof, >0:not eof             */
1960     return (*funcp)(aTHXo_ idx, buf_sv, maxlen);
1961 }
1962
1963 STATIC char *
1964 S_filter_gets(pTHX_ register SV *sv, register PerlIO *fp, STRLEN append)
1965 {
1966 #ifdef PERL_CR_FILTER
1967     if (!PL_rsfp_filters) {
1968         filter_add(S_cr_textfilter,NULL);
1969     }
1970 #endif
1971     if (PL_rsfp_filters) {
1972
1973         if (!append)
1974             SvCUR_set(sv, 0);   /* start with empty line        */
1975         if (FILTER_READ(0, sv, 0) > 0)
1976             return ( SvPVX(sv) ) ;
1977         else
1978             return Nullch ;
1979     }
1980     else
1981         return (sv_gets(sv, fp, append));
1982 }
1983
1984
1985 #ifdef DEBUGGING
1986     static char* exp_name[] =
1987         { "OPERATOR", "TERM", "REF", "STATE", "BLOCK", "ATTRBLOCK",
1988           "ATTRTERM", "TERMBLOCK"
1989         };
1990 #endif
1991
1992 /*
1993   yylex
1994
1995   Works out what to call the token just pulled out of the input
1996   stream.  The yacc parser takes care of taking the ops we return and
1997   stitching them into a tree.
1998
1999   Returns:
2000     PRIVATEREF
2001
2002   Structure:
2003       if read an identifier
2004           if we're in a my declaration
2005               croak if they tried to say my($foo::bar)
2006               build the ops for a my() declaration
2007           if it's an access to a my() variable
2008               are we in a sort block?
2009                   croak if my($a); $a <=> $b
2010               build ops for access to a my() variable
2011           if in a dq string, and they've said @foo and we can't find @foo
2012               croak
2013           build ops for a bareword
2014       if we already built the token before, use it.
2015 */
2016
2017 int
2018 #ifdef USE_PURE_BISON
2019 Perl_yylex(pTHX_ YYSTYPE *lvalp, int *lcharp)
2020 #else
2021 Perl_yylex(pTHX)
2022 #endif
2023 {
2024     dTHR;
2025     register char *s;
2026     register char *d;
2027     register I32 tmp;
2028     STRLEN len;
2029     GV *gv = Nullgv;
2030     GV **gvp = 0;
2031
2032 #ifdef USE_PURE_BISON
2033     yylval_pointer = lvalp;
2034     yychar_pointer = lcharp;
2035 #endif
2036
2037     /* check if there's an identifier for us to look at */
2038     if (PL_pending_ident) {
2039         /* pit holds the identifier we read and pending_ident is reset */
2040         char pit = PL_pending_ident;
2041         PL_pending_ident = 0;
2042
2043         /* if we're in a my(), we can't allow dynamics here.
2044            $foo'bar has already been turned into $foo::bar, so
2045            just check for colons.
2046
2047            if it's a legal name, the OP is a PADANY.
2048         */
2049         if (PL_in_my) {
2050             if (PL_in_my == KEY_our) {  /* "our" is merely analogous to "my" */
2051                 if (strchr(PL_tokenbuf,':'))
2052                     yyerror(Perl_form(aTHX_ "No package name allowed for "
2053                                       "variable %s in \"our\"",
2054                                       PL_tokenbuf));
2055                 tmp = pad_allocmy(PL_tokenbuf);
2056             }
2057             else {
2058                 if (strchr(PL_tokenbuf,':'))
2059                     yyerror(Perl_form(aTHX_ PL_no_myglob,PL_tokenbuf));
2060
2061                 yylval.opval = newOP(OP_PADANY, 0);
2062                 yylval.opval->op_targ = pad_allocmy(PL_tokenbuf);
2063                 return PRIVATEREF;
2064             }
2065         }
2066
2067         /* 
2068            build the ops for accesses to a my() variable.
2069
2070            Deny my($a) or my($b) in a sort block, *if* $a or $b is
2071            then used in a comparison.  This catches most, but not
2072            all cases.  For instance, it catches
2073                sort { my($a); $a <=> $b }
2074            but not
2075                sort { my($a); $a < $b ? -1 : $a == $b ? 0 : 1; }
2076            (although why you'd do that is anyone's guess).
2077         */
2078
2079         if (!strchr(PL_tokenbuf,':')) {
2080 #ifdef USE_THREADS
2081             /* Check for single character per-thread SVs */
2082             if (PL_tokenbuf[0] == '$' && PL_tokenbuf[2] == '\0'
2083                 && !isALPHA(PL_tokenbuf[1]) /* Rule out obvious non-threadsvs */
2084                 && (tmp = find_threadsv(&PL_tokenbuf[1])) != NOT_IN_PAD)
2085             {
2086                 yylval.opval = newOP(OP_THREADSV, 0);
2087                 yylval.opval->op_targ = tmp;
2088                 return PRIVATEREF;
2089             }
2090 #endif /* USE_THREADS */
2091             if ((tmp = pad_findmy(PL_tokenbuf)) != NOT_IN_PAD) {
2092                 SV *namesv = AvARRAY(PL_comppad_name)[tmp];
2093                 /* might be an "our" variable" */
2094                 if (SvFLAGS(namesv) & SVpad_OUR) {
2095                     /* build ops for a bareword */
2096                     SV *sym = newSVpv(HvNAME(GvSTASH(namesv)),0);
2097                     sv_catpvn(sym, "::", 2);
2098                     sv_catpv(sym, PL_tokenbuf+1);
2099                     yylval.opval = (OP*)newSVOP(OP_CONST, 0, sym);
2100                     yylval.opval->op_private = OPpCONST_ENTERED;
2101                     gv_fetchpv(SvPVX(sym),
2102                         (PL_in_eval
2103                             ? (GV_ADDMULTI | GV_ADDINEVAL)
2104                             : TRUE
2105                         ),
2106                         ((PL_tokenbuf[0] == '$') ? SVt_PV
2107                          : (PL_tokenbuf[0] == '@') ? SVt_PVAV
2108                          : SVt_PVHV));
2109                     return WORD;
2110                 }
2111
2112                 /* if it's a sort block and they're naming $a or $b */
2113                 if (PL_last_lop_op == OP_SORT &&
2114                     PL_tokenbuf[0] == '$' &&
2115                     (PL_tokenbuf[1] == 'a' || PL_tokenbuf[1] == 'b')
2116                     && !PL_tokenbuf[2])
2117                 {
2118                     for (d = PL_in_eval ? PL_oldoldbufptr : PL_linestart;
2119                          d < PL_bufend && *d != '\n';
2120                          d++)
2121                     {
2122                         if (strnEQ(d,"<=>",3) || strnEQ(d,"cmp",3)) {
2123                             Perl_croak(aTHX_ "Can't use \"my %s\" in sort comparison",
2124                                   PL_tokenbuf);
2125                         }
2126                     }
2127                 }
2128
2129                 yylval.opval = newOP(OP_PADANY, 0);
2130                 yylval.opval->op_targ = tmp;
2131                 return PRIVATEREF;
2132             }
2133         }
2134
2135         /*
2136            Whine if they've said @foo in a doublequoted string,
2137            and @foo isn't a variable we can find in the symbol
2138            table.
2139         */
2140         if (pit == '@' && PL_lex_state != LEX_NORMAL && !PL_lex_brackets) {
2141             GV *gv = gv_fetchpv(PL_tokenbuf+1, FALSE, SVt_PVAV);
2142             if (!gv || ((PL_tokenbuf[0] == '@') ? !GvAV(gv) : !GvHV(gv)))
2143                 yyerror(Perl_form(aTHX_ "In string, %s now must be written as \\%s",
2144                              PL_tokenbuf, PL_tokenbuf));
2145         }
2146
2147         /* build ops for a bareword */
2148         yylval.opval = (OP*)newSVOP(OP_CONST, 0, newSVpv(PL_tokenbuf+1, 0));
2149         yylval.opval->op_private = OPpCONST_ENTERED;
2150         gv_fetchpv(PL_tokenbuf+1, PL_in_eval ? (GV_ADDMULTI | GV_ADDINEVAL) : TRUE,
2151                    ((PL_tokenbuf[0] == '$') ? SVt_PV
2152                     : (PL_tokenbuf[0] == '@') ? SVt_PVAV
2153                     : SVt_PVHV));
2154         return WORD;
2155     }
2156
2157     /* no identifier pending identification */
2158
2159     switch (PL_lex_state) {
2160 #ifdef COMMENTARY
2161     case LEX_NORMAL:            /* Some compilers will produce faster */
2162     case LEX_INTERPNORMAL:      /* code if we comment these out. */
2163         break;
2164 #endif
2165
2166     /* when we've already built the next token, just pull it out of the queue */
2167     case LEX_KNOWNEXT:
2168         PL_nexttoke--;
2169         yylval = PL_nextval[PL_nexttoke];
2170         if (!PL_nexttoke) {
2171             PL_lex_state = PL_lex_defer;
2172             PL_expect = PL_lex_expect;
2173             PL_lex_defer = LEX_NORMAL;
2174         }
2175         return(PL_nexttype[PL_nexttoke]);
2176
2177     /* interpolated case modifiers like \L \U, including \Q and \E.
2178        when we get here, PL_bufptr is at the \
2179     */
2180     case LEX_INTERPCASEMOD:
2181 #ifdef DEBUGGING
2182         if (PL_bufptr != PL_bufend && *PL_bufptr != '\\')
2183             Perl_croak(aTHX_ "panic: INTERPCASEMOD");
2184 #endif
2185         /* handle \E or end of string */
2186         if (PL_bufptr == PL_bufend || PL_bufptr[1] == 'E') {
2187             char oldmod;
2188
2189             /* if at a \E */
2190             if (PL_lex_casemods) {
2191                 oldmod = PL_lex_casestack[--PL_lex_casemods];
2192                 PL_lex_casestack[PL_lex_casemods] = '\0';
2193
2194                 if (PL_bufptr != PL_bufend && strchr("LUQ", oldmod)) {
2195                     PL_bufptr += 2;
2196                     PL_lex_state = LEX_INTERPCONCAT;
2197                 }
2198                 return ')';
2199             }
2200             if (PL_bufptr != PL_bufend)
2201                 PL_bufptr += 2;
2202             PL_lex_state = LEX_INTERPCONCAT;
2203             return yylex();
2204         }
2205         else {
2206             s = PL_bufptr + 1;
2207             if (strnEQ(s, "L\\u", 3) || strnEQ(s, "U\\l", 3))
2208                 tmp = *s, *s = s[2], s[2] = tmp;        /* misordered... */
2209             if (strchr("LU", *s) &&
2210                 (strchr(PL_lex_casestack, 'L') || strchr(PL_lex_casestack, 'U')))
2211             {
2212                 PL_lex_casestack[--PL_lex_casemods] = '\0';
2213                 return ')';
2214             }
2215             if (PL_lex_casemods > 10) {
2216                 char* newlb = Renew(PL_lex_casestack, PL_lex_casemods + 2, char);
2217                 if (newlb != PL_lex_casestack) {
2218                     SAVEFREEPV(newlb);
2219                     PL_lex_casestack = newlb;
2220                 }
2221             }
2222             PL_lex_casestack[PL_lex_casemods++] = *s;
2223             PL_lex_casestack[PL_lex_casemods] = '\0';
2224             PL_lex_state = LEX_INTERPCONCAT;
2225             PL_nextval[PL_nexttoke].ival = 0;
2226             force_next('(');
2227             if (*s == 'l')
2228                 PL_nextval[PL_nexttoke].ival = OP_LCFIRST;
2229             else if (*s == 'u')
2230                 PL_nextval[PL_nexttoke].ival = OP_UCFIRST;
2231             else if (*s == 'L')
2232                 PL_nextval[PL_nexttoke].ival = OP_LC;
2233             else if (*s == 'U')
2234                 PL_nextval[PL_nexttoke].ival = OP_UC;
2235             else if (*s == 'Q')
2236                 PL_nextval[PL_nexttoke].ival = OP_QUOTEMETA;
2237             else
2238                 Perl_croak(aTHX_ "panic: yylex");
2239             PL_bufptr = s + 1;
2240             force_next(FUNC);
2241             if (PL_lex_starts) {
2242                 s = PL_bufptr;
2243                 PL_lex_starts = 0;
2244                 Aop(OP_CONCAT);
2245             }
2246             else
2247                 return yylex();
2248         }
2249
2250     case LEX_INTERPPUSH:
2251         return sublex_push();
2252
2253     case LEX_INTERPSTART:
2254         if (PL_bufptr == PL_bufend)
2255             return sublex_done();
2256         PL_expect = XTERM;
2257         PL_lex_dojoin = (*PL_bufptr == '@');
2258         PL_lex_state = LEX_INTERPNORMAL;
2259         if (PL_lex_dojoin) {
2260             PL_nextval[PL_nexttoke].ival = 0;
2261             force_next(',');
2262 #ifdef USE_THREADS
2263             PL_nextval[PL_nexttoke].opval = newOP(OP_THREADSV, 0);
2264             PL_nextval[PL_nexttoke].opval->op_targ = find_threadsv("\"");
2265             force_next(PRIVATEREF);
2266 #else
2267             force_ident("\"", '$');
2268 #endif /* USE_THREADS */
2269             PL_nextval[PL_nexttoke].ival = 0;
2270             force_next('$');
2271             PL_nextval[PL_nexttoke].ival = 0;
2272             force_next('(');
2273             PL_nextval[PL_nexttoke].ival = OP_JOIN;     /* emulate join($", ...) */
2274             force_next(FUNC);
2275         }
2276         if (PL_lex_starts++) {
2277             s = PL_bufptr;
2278             Aop(OP_CONCAT);
2279         }
2280         return yylex();
2281
2282     case LEX_INTERPENDMAYBE:
2283         if (intuit_more(PL_bufptr)) {
2284             PL_lex_state = LEX_INTERPNORMAL;    /* false alarm, more expr */
2285             break;
2286         }
2287         /* FALL THROUGH */
2288
2289     case LEX_INTERPEND:
2290         if (PL_lex_dojoin) {
2291             PL_lex_dojoin = FALSE;
2292             PL_lex_state = LEX_INTERPCONCAT;
2293             return ')';
2294         }
2295         if (PL_lex_inwhat == OP_SUBST && PL_linestr == PL_lex_repl
2296             && SvEVALED(PL_lex_repl))
2297         {
2298             if (PL_bufptr != PL_bufend)
2299                 Perl_croak(aTHX_ "Bad evalled substitution pattern");
2300             PL_lex_repl = Nullsv;
2301         }
2302         /* FALLTHROUGH */
2303     case LEX_INTERPCONCAT:
2304 #ifdef DEBUGGING
2305         if (PL_lex_brackets)
2306             Perl_croak(aTHX_ "panic: INTERPCONCAT");
2307 #endif
2308         if (PL_bufptr == PL_bufend)
2309             return sublex_done();
2310
2311         if (SvIVX(PL_linestr) == '\'') {
2312             SV *sv = newSVsv(PL_linestr);
2313             if (!PL_lex_inpat)
2314                 sv = tokeq(sv);
2315             else if ( PL_hints & HINT_NEW_RE )
2316                 sv = new_constant(NULL, 0, "qr", sv, sv, "q");
2317             yylval.opval = (OP*)newSVOP(OP_CONST, 0, sv);
2318             s = PL_bufend;
2319         }
2320         else {
2321             s = scan_const(PL_bufptr);
2322             if (*s == '\\')
2323                 PL_lex_state = LEX_INTERPCASEMOD;
2324             else
2325                 PL_lex_state = LEX_INTERPSTART;
2326         }
2327
2328         if (s != PL_bufptr) {
2329             PL_nextval[PL_nexttoke] = yylval;
2330             PL_expect = XTERM;
2331             force_next(THING);
2332             if (PL_lex_starts++)
2333                 Aop(OP_CONCAT);
2334             else {
2335                 PL_bufptr = s;
2336                 return yylex();
2337             }
2338         }
2339
2340         return yylex();
2341     case LEX_FORMLINE:
2342         PL_lex_state = LEX_NORMAL;
2343         s = scan_formline(PL_bufptr);
2344         if (!PL_lex_formbrack)
2345             goto rightbracket;
2346         OPERATOR(';');
2347     }
2348
2349     s = PL_bufptr;
2350     PL_oldoldbufptr = PL_oldbufptr;
2351     PL_oldbufptr = s;
2352     DEBUG_p( {
2353         PerlIO_printf(Perl_debug_log, "### Tokener expecting %s at %s\n",
2354                       exp_name[PL_expect], s);
2355     } )
2356
2357   retry:
2358     switch (*s) {
2359     default:
2360         if (isIDFIRST_lazy_if(s,UTF))
2361             goto keylookup;
2362         Perl_croak(aTHX_ "Unrecognized character \\x%02X", *s & 255);
2363     case 4:
2364     case 26:
2365         goto fake_eof;                  /* emulate EOF on ^D or ^Z */
2366     case 0:
2367         if (!PL_rsfp) {
2368             PL_last_uni = 0;
2369             PL_last_lop = 0;
2370             if (PL_lex_brackets)
2371                 yyerror("Missing right curly or square bracket");
2372             TOKEN(0);
2373         }
2374         if (s++ < PL_bufend)
2375             goto retry;                 /* ignore stray nulls */
2376         PL_last_uni = 0;
2377         PL_last_lop = 0;
2378         if (!PL_in_eval && !PL_preambled) {
2379             PL_preambled = TRUE;
2380             sv_setpv(PL_linestr,incl_perldb());
2381             if (SvCUR(PL_linestr))
2382                 sv_catpv(PL_linestr,";");
2383             if (PL_preambleav){
2384                 while(AvFILLp(PL_preambleav) >= 0) {
2385                     SV *tmpsv = av_shift(PL_preambleav);
2386                     sv_catsv(PL_linestr, tmpsv);
2387                     sv_catpv(PL_linestr, ";");
2388                     sv_free(tmpsv);
2389                 }
2390                 sv_free((SV*)PL_preambleav);
2391                 PL_preambleav = NULL;
2392             }
2393             if (PL_minus_n || PL_minus_p) {
2394                 sv_catpv(PL_linestr, "LINE: while (<>) {");
2395                 if (PL_minus_l)
2396                     sv_catpv(PL_linestr,"chomp;");
2397                 if (PL_minus_a) {
2398                     GV* gv = gv_fetchpv("::F", TRUE, SVt_PVAV);
2399                     if (gv)
2400                         GvIMPORTED_AV_on(gv);
2401                     if (PL_minus_F) {
2402                         if (strchr("/'\"", *PL_splitstr)
2403                               && strchr(PL_splitstr + 1, *PL_splitstr))
2404                             Perl_sv_catpvf(aTHX_ PL_linestr, "@F=split(%s);", PL_splitstr);
2405                         else {
2406                             char delim;
2407                             s = "'~#\200\1'"; /* surely one char is unused...*/
2408                             while (s[1] && strchr(PL_splitstr, *s))  s++;
2409                             delim = *s;
2410                             Perl_sv_catpvf(aTHX_ PL_linestr, "@F=split(%s%c",
2411                                       "q" + (delim == '\''), delim);
2412                             for (s = PL_splitstr; *s; s++) {
2413                                 if (*s == '\\')
2414                                     sv_catpvn(PL_linestr, "\\", 1);
2415                                 sv_catpvn(PL_linestr, s, 1);
2416                             }
2417                             Perl_sv_catpvf(aTHX_ PL_linestr, "%c);", delim);
2418                         }
2419                     }
2420                     else
2421                         sv_catpv(PL_linestr,"@F=split(' ');");
2422                 }
2423             }
2424             sv_catpv(PL_linestr, "\n");
2425             PL_oldoldbufptr = PL_oldbufptr = s = PL_linestart = SvPVX(PL_linestr);
2426             PL_bufend = SvPVX(PL_linestr) + SvCUR(PL_linestr);
2427             if (PERLDB_LINE && PL_curstash != PL_debstash) {
2428                 SV *sv = NEWSV(85,0);
2429
2430                 sv_upgrade(sv, SVt_PVMG);
2431                 sv_setsv(sv,PL_linestr);
2432                 av_store(CopFILEAV(PL_curcop),(I32)CopLINE(PL_curcop),sv);
2433             }
2434             goto retry;
2435         }
2436         do {
2437             if ((s = filter_gets(PL_linestr, PL_rsfp, 0)) == Nullch) {
2438               fake_eof:
2439                 if (PL_rsfp) {
2440                     if (PL_preprocess && !PL_in_eval)
2441                         (void)PerlProc_pclose(PL_rsfp);
2442                     else if ((PerlIO *)PL_rsfp == PerlIO_stdin())
2443                         PerlIO_clearerr(PL_rsfp);
2444                     else
2445                         (void)PerlIO_close(PL_rsfp);
2446                     PL_rsfp = Nullfp;
2447                     PL_doextract = FALSE;
2448                 }
2449                 if (!PL_in_eval && (PL_minus_n || PL_minus_p)) {
2450                     sv_setpv(PL_linestr,PL_minus_p ? ";}continue{print" : "");
2451                     sv_catpv(PL_linestr,";}");
2452                     PL_oldoldbufptr = PL_oldbufptr = s = PL_linestart = SvPVX(PL_linestr);
2453                     PL_bufend = SvPVX(PL_linestr) + SvCUR(PL_linestr);
2454                     PL_minus_n = PL_minus_p = 0;
2455                     goto retry;
2456                 }
2457                 PL_oldoldbufptr = PL_oldbufptr = s = PL_linestart = SvPVX(PL_linestr);
2458                 sv_setpv(PL_linestr,"");
2459                 TOKEN(';');     /* not infinite loop because rsfp is NULL now */
2460             }
2461             if (PL_doextract) {
2462                 if (*s == '#' && s[1] == '!' && instr(s,"perl"))
2463                     PL_doextract = FALSE;
2464
2465                 /* Incest with pod. */
2466                 if (*s == '=' && strnEQ(s, "=cut", 4)) {
2467                     sv_setpv(PL_linestr, "");
2468                     PL_oldoldbufptr = PL_oldbufptr = s = PL_linestart = SvPVX(PL_linestr);
2469                     PL_bufend = SvPVX(PL_linestr) + SvCUR(PL_linestr);
2470                     PL_doextract = FALSE;
2471                 }
2472             }
2473             incline(s);
2474         } while (PL_doextract);
2475         PL_oldoldbufptr = PL_oldbufptr = PL_bufptr = PL_linestart = s;
2476         if (PERLDB_LINE && PL_curstash != PL_debstash) {
2477             SV *sv = NEWSV(85,0);
2478
2479             sv_upgrade(sv, SVt_PVMG);
2480             sv_setsv(sv,PL_linestr);
2481             av_store(CopFILEAV(PL_curcop),(I32)CopLINE(PL_curcop),sv);
2482         }
2483         PL_bufend = SvPVX(PL_linestr) + SvCUR(PL_linestr);
2484         if (CopLINE(PL_curcop) == 1) {
2485             while (s < PL_bufend && isSPACE(*s))
2486                 s++;
2487             if (*s == ':' && s[1] != ':') /* for csh execing sh scripts */
2488                 s++;
2489             d = Nullch;
2490             if (!PL_in_eval) {
2491                 if (*s == '#' && *(s+1) == '!')
2492                     d = s + 2;
2493 #ifdef ALTERNATE_SHEBANG
2494                 else {
2495                     static char as[] = ALTERNATE_SHEBANG;
2496                     if (*s == as[0] && strnEQ(s, as, sizeof(as) - 1))
2497                         d = s + (sizeof(as) - 1);
2498                 }
2499 #endif /* ALTERNATE_SHEBANG */
2500             }
2501             if (d) {
2502                 char *ipath;
2503                 char *ipathend;
2504
2505                 while (isSPACE(*d))
2506                     d++;
2507                 ipath = d;
2508                 while (*d && !isSPACE(*d))
2509                     d++;
2510                 ipathend = d;
2511
2512 #ifdef ARG_ZERO_IS_SCRIPT
2513                 if (ipathend > ipath) {
2514                     /*
2515                      * HP-UX (at least) sets argv[0] to the script name,
2516                      * which makes $^X incorrect.  And Digital UNIX and Linux,
2517                      * at least, set argv[0] to the basename of the Perl
2518                      * interpreter. So, having found "#!", we'll set it right.
2519                      */
2520                     SV *x = GvSV(gv_fetchpv("\030", TRUE, SVt_PV));
2521                     assert(SvPOK(x) || SvGMAGICAL(x));
2522                     if (sv_eq(x, CopFILESV(PL_curcop))) {
2523                         sv_setpvn(x, ipath, ipathend - ipath);
2524                         SvSETMAGIC(x);
2525                     }
2526                     TAINT_NOT;  /* $^X is always tainted, but that's OK */
2527                 }
2528 #endif /* ARG_ZERO_IS_SCRIPT */
2529
2530                 /*
2531                  * Look for options.
2532                  */
2533                 d = instr(s,"perl -");
2534                 if (!d) {
2535                     d = instr(s,"perl");
2536 #if defined(DOSISH)
2537                     /* avoid getting into infinite loops when shebang
2538                      * line contains "Perl" rather than "perl" */
2539                     if (!d) {
2540                         for (d = ipathend-4; d >= ipath; --d) {
2541                             if ((*d == 'p' || *d == 'P')
2542                                 && !ibcmp(d, "perl", 4))
2543                             {
2544                                 break;
2545                             }
2546                         }
2547                         if (d < ipath)
2548                             d = Nullch;
2549                     }
2550 #endif
2551                 }
2552 #ifdef ALTERNATE_SHEBANG
2553                 /*
2554                  * If the ALTERNATE_SHEBANG on this system starts with a
2555                  * character that can be part of a Perl expression, then if
2556                  * we see it but not "perl", we're probably looking at the
2557                  * start of Perl code, not a request to hand off to some
2558                  * other interpreter.  Similarly, if "perl" is there, but
2559                  * not in the first 'word' of the line, we assume the line
2560                  * contains the start of the Perl program.
2561                  */
2562                 if (d && *s != '#') {
2563                     char *c = ipath;
2564                     while (*c && !strchr("; \t\r\n\f\v#", *c))
2565                         c++;
2566                     if (c < d)
2567                         d = Nullch;     /* "perl" not in first word; ignore */
2568                     else
2569                         *s = '#';       /* Don't try to parse shebang line */
2570                 }
2571 #endif /* ALTERNATE_SHEBANG */
2572                 if (!d &&
2573                     *s == '#' &&
2574                     ipathend > ipath &&
2575                     !PL_minus_c &&
2576                     !instr(s,"indir") &&
2577                     instr(PL_origargv[0],"perl"))
2578                 {
2579                     char **newargv;
2580
2581                     *ipathend = '\0';
2582                     s = ipathend + 1;
2583                     while (s < PL_bufend && isSPACE(*s))
2584                         s++;
2585                     if (s < PL_bufend) {
2586                         Newz(899,newargv,PL_origargc+3,char*);
2587                         newargv[1] = s;
2588                         while (s < PL_bufend && !isSPACE(*s))
2589                             s++;
2590                         *s = '\0';
2591                         Copy(PL_origargv+1, newargv+2, PL_origargc+1, char*);
2592                     }
2593                     else
2594                         newargv = PL_origargv;
2595                     newargv[0] = ipath;
2596                     PerlProc_execv(ipath, newargv);
2597                     Perl_croak(aTHX_ "Can't exec %s", ipath);
2598                 }
2599                 if (d) {
2600                     U32 oldpdb = PL_perldb;
2601                     bool oldn = PL_minus_n;
2602                     bool oldp = PL_minus_p;
2603
2604                     while (*d && !isSPACE(*d)) d++;
2605                     while (*d == ' ' || *d == '\t') d++;
2606
2607                     if (*d++ == '-') {
2608                         do {
2609                             if (*d == 'M' || *d == 'm') {
2610                                 char *m = d;
2611                                 while (*d && !isSPACE(*d)) d++;
2612                                 Perl_croak(aTHX_ "Too late for \"-%.*s\" option",
2613                                       (int)(d - m), m);
2614                             }
2615                             d = moreswitches(d);
2616                         } while (d);
2617                         if ((PERLDB_LINE && !oldpdb) ||
2618                             ((PL_minus_n || PL_minus_p) && !(oldn || oldp)))
2619                               /* if we have already added "LINE: while (<>) {",
2620                                  we must not do it again */
2621                         {
2622                             sv_setpv(PL_linestr, "");
2623                             PL_oldoldbufptr = PL_oldbufptr = s = PL_linestart = SvPVX(PL_linestr);
2624                             PL_bufend = SvPVX(PL_linestr) + SvCUR(PL_linestr);
2625                             PL_preambled = FALSE;
2626                             if (PERLDB_LINE)
2627                                 (void)gv_fetchfile(PL_origfilename);
2628                             goto retry;
2629                         }
2630                     }
2631                 }
2632             }
2633         }
2634         if (PL_lex_formbrack && PL_lex_brackets <= PL_lex_formbrack) {
2635             PL_bufptr = s;
2636             PL_lex_state = LEX_FORMLINE;
2637             return yylex();
2638         }
2639         goto retry;
2640     case '\r':
2641 #ifdef PERL_STRICT_CR
2642         Perl_warn(aTHX_ "Illegal character \\%03o (carriage return)", '\r');
2643         Perl_croak(aTHX_ 
2644       "(Maybe you didn't strip carriage returns after a network transfer?)\n");
2645 #endif
2646     case ' ': case '\t': case '\f': case 013:
2647         s++;
2648         goto retry;
2649     case '#':
2650     case '\n':
2651         if (PL_lex_state != LEX_NORMAL || (PL_in_eval && !PL_rsfp)) {
2652             d = PL_bufend;
2653             while (s < d && *s != '\n')
2654                 s++;
2655             if (s < d)
2656                 s++;
2657             incline(s);
2658             if (PL_lex_formbrack && PL_lex_brackets <= PL_lex_formbrack) {
2659                 PL_bufptr = s;
2660                 PL_lex_state = LEX_FORMLINE;
2661                 return yylex();
2662             }
2663         }
2664         else {
2665             *s = '\0';
2666             PL_bufend = s;
2667         }
2668         goto retry;
2669     case '-':
2670         if (s[1] && isALPHA(s[1]) && !isALNUM(s[2])) {
2671             s++;
2672             PL_bufptr = s;
2673             tmp = *s++;
2674
2675             while (s < PL_bufend && (*s == ' ' || *s == '\t'))
2676                 s++;
2677
2678             if (strnEQ(s,"=>",2)) {
2679                 s = force_word(PL_bufptr,WORD,FALSE,FALSE,FALSE);
2680                 OPERATOR('-');          /* unary minus */
2681             }
2682             PL_last_uni = PL_oldbufptr;
2683             PL_last_lop_op = OP_FTEREAD;        /* good enough */
2684             switch (tmp) {
2685             case 'r': FTST(OP_FTEREAD);
2686             case 'w': FTST(OP_FTEWRITE);
2687             case 'x': FTST(OP_FTEEXEC);
2688             case 'o': FTST(OP_FTEOWNED);
2689             case 'R': FTST(OP_FTRREAD);
2690             case 'W': FTST(OP_FTRWRITE);
2691             case 'X': FTST(OP_FTREXEC);
2692             case 'O': FTST(OP_FTROWNED);
2693             case 'e': FTST(OP_FTIS);
2694             case 'z': FTST(OP_FTZERO);
2695             case 's': FTST(OP_FTSIZE);
2696             case 'f': FTST(OP_FTFILE);
2697             case 'd': FTST(OP_FTDIR);
2698             case 'l': FTST(OP_FTLINK);
2699             case 'p': FTST(OP_FTPIPE);
2700             case 'S': FTST(OP_FTSOCK);
2701             case 'u': FTST(OP_FTSUID);
2702             case 'g': FTST(OP_FTSGID);
2703             case 'k': FTST(OP_FTSVTX);
2704             case 'b': FTST(OP_FTBLK);
2705             case 'c': FTST(OP_FTCHR);
2706             case 't': FTST(OP_FTTTY);
2707             case 'T': FTST(OP_FTTEXT);
2708             case 'B': FTST(OP_FTBINARY);
2709             case 'M': gv_fetchpv("\024",TRUE, SVt_PV); FTST(OP_FTMTIME);
2710             case 'A': gv_fetchpv("\024",TRUE, SVt_PV); FTST(OP_FTATIME);
2711             case 'C': gv_fetchpv("\024",TRUE, SVt_PV); FTST(OP_FTCTIME);
2712             default:
2713                 Perl_croak(aTHX_ "Unrecognized file test: -%c", (int)tmp);
2714                 break;
2715             }
2716         }
2717         tmp = *s++;
2718         if (*s == tmp) {
2719             s++;
2720             if (PL_expect == XOPERATOR)
2721                 TERM(POSTDEC);
2722             else
2723                 OPERATOR(PREDEC);
2724         }
2725         else if (*s == '>') {
2726             s++;
2727             s = skipspace(s);
2728             if (isIDFIRST_lazy_if(s,UTF)) {
2729                 s = force_word(s,METHOD,FALSE,TRUE,FALSE);
2730                 TOKEN(ARROW);
2731             }
2732             else if (*s == '$')
2733                 OPERATOR(ARROW);
2734             else
2735                 TERM(ARROW);
2736         }
2737         if (PL_expect == XOPERATOR)
2738             Aop(OP_SUBTRACT);
2739         else {
2740             if (isSPACE(*s) || !isSPACE(*PL_bufptr))
2741                 check_uni();
2742             OPERATOR('-');              /* unary minus */
2743         }
2744
2745     case '+':
2746         tmp = *s++;
2747         if (*s == tmp) {
2748             s++;
2749             if (PL_expect == XOPERATOR)
2750                 TERM(POSTINC);
2751             else
2752                 OPERATOR(PREINC);
2753         }
2754         if (PL_expect == XOPERATOR)
2755             Aop(OP_ADD);
2756         else {
2757             if (isSPACE(*s) || !isSPACE(*PL_bufptr))
2758                 check_uni();
2759             OPERATOR('+');
2760         }
2761
2762     case '*':
2763         if (PL_expect != XOPERATOR) {
2764             s = scan_ident(s, PL_bufend, PL_tokenbuf, sizeof PL_tokenbuf, TRUE);
2765             PL_expect = XOPERATOR;
2766             force_ident(PL_tokenbuf, '*');
2767             if (!*PL_tokenbuf)
2768                 PREREF('*');
2769             TERM('*');
2770         }
2771         s++;
2772         if (*s == '*') {
2773             s++;
2774             PWop(OP_POW);
2775         }
2776         Mop(OP_MULTIPLY);
2777
2778     case '%':
2779         if (PL_expect == XOPERATOR) {
2780             ++s;
2781             Mop(OP_MODULO);
2782         }
2783         PL_tokenbuf[0] = '%';
2784         s = scan_ident(s, PL_bufend, PL_tokenbuf + 1, sizeof PL_tokenbuf - 1, TRUE);
2785         if (!PL_tokenbuf[1]) {
2786             if (s == PL_bufend)
2787                 yyerror("Final % should be \\% or %name");
2788             PREREF('%');
2789         }
2790         PL_pending_ident = '%';
2791         TERM('%');
2792
2793     case '^':
2794         s++;
2795         BOop(OP_BIT_XOR);
2796     case '[':
2797         PL_lex_brackets++;
2798         /* FALL THROUGH */
2799     case '~':
2800     case ',':
2801         tmp = *s++;
2802         OPERATOR(tmp);
2803     case ':':
2804         if (s[1] == ':') {
2805             len = 0;
2806             goto just_a_word;
2807         }
2808         s++;
2809         switch (PL_expect) {
2810             OP *attrs;
2811         case XOPERATOR:
2812             if (!PL_in_my || PL_lex_state != LEX_NORMAL)
2813                 break;
2814             PL_bufptr = s;      /* update in case we back off */
2815             goto grabattrs;
2816         case XATTRBLOCK:
2817             PL_expect = XBLOCK;
2818             goto grabattrs;
2819         case XATTRTERM:
2820             PL_expect = XTERMBLOCK;
2821          grabattrs:
2822             s = skipspace(s);
2823             attrs = Nullop;
2824             while (isIDFIRST_lazy_if(s,UTF)) {
2825                 d = scan_word(s, PL_tokenbuf, sizeof PL_tokenbuf, FALSE, &len);
2826                 if (isLOWER(*s) && (tmp = keyword(PL_tokenbuf, len))) {
2827                     if (tmp < 0) tmp = -tmp;
2828                     switch (tmp) {
2829                     case KEY_or:
2830                     case KEY_and:
2831                     case KEY_for:
2832                     case KEY_unless:
2833                     case KEY_if:
2834                     case KEY_while:
2835                     case KEY_until:
2836                         goto got_attrs;
2837                     default:
2838                         break;
2839                     }
2840                 }
2841                 if (*d == '(') {
2842                     d = scan_str(d,TRUE,TRUE);
2843                     if (!d) {
2844                         if (PL_lex_stuff) {
2845                             SvREFCNT_dec(PL_lex_stuff);
2846                             PL_lex_stuff = Nullsv;
2847                         }
2848                         /* MUST advance bufptr here to avoid bogus
2849                            "at end of line" context messages from yyerror().
2850                          */
2851                         PL_bufptr = s + len;
2852                         yyerror("Unterminated attribute parameter in attribute list");
2853                         if (attrs)
2854                             op_free(attrs);
2855                         return 0;       /* EOF indicator */
2856                     }
2857                 }
2858                 if (PL_lex_stuff) {
2859                     SV *sv = newSVpvn(s, len);
2860                     sv_catsv(sv, PL_lex_stuff);
2861                     attrs = append_elem(OP_LIST, attrs,
2862                                         newSVOP(OP_CONST, 0, sv));
2863                     SvREFCNT_dec(PL_lex_stuff);
2864                     PL_lex_stuff = Nullsv;
2865                 }
2866                 else {
2867                     attrs = append_elem(OP_LIST, attrs,
2868                                         newSVOP(OP_CONST, 0,
2869                                                 newSVpvn(s, len)));
2870                 }
2871                 s = skipspace(d);
2872                 if (*s == ':' && s[1] != ':')
2873                     s = skipspace(s+1);
2874                 else if (s == d)
2875                     break;      /* require real whitespace or :'s */
2876             }
2877             tmp = (PL_expect == XOPERATOR ? '=' : '{'); /*'}(' for vi */
2878             if (*s != ';' && *s != tmp && (tmp != '=' || *s != ')')) {
2879                 char q = ((*s == '\'') ? '"' : '\'');
2880                 /* If here for an expression, and parsed no attrs, back off. */
2881                 if (tmp == '=' && !attrs) {
2882                     s = PL_bufptr;
2883                     break;
2884                 }
2885                 /* MUST advance bufptr here to avoid bogus "at end of line"
2886                    context messages from yyerror().
2887                  */
2888                 PL_bufptr = s;
2889                 if (!*s)
2890                     yyerror("Unterminated attribute list");
2891                 else
2892                     yyerror(Perl_form(aTHX_ "Invalid separator character %c%c%c in attribute list",
2893                                       q, *s, q));
2894                 if (attrs)
2895                     op_free(attrs);
2896                 OPERATOR(':');
2897             }
2898         got_attrs:
2899             if (attrs) {
2900                 PL_nextval[PL_nexttoke].opval = attrs;
2901                 force_next(THING);
2902             }
2903             TOKEN(COLONATTR);
2904         }
2905         OPERATOR(':');
2906     case '(':
2907         s++;
2908         if (PL_last_lop == PL_oldoldbufptr || PL_last_uni == PL_oldoldbufptr)
2909             PL_oldbufptr = PL_oldoldbufptr;             /* allow print(STDOUT 123) */
2910         else
2911             PL_expect = XTERM;
2912         TOKEN('(');
2913     case ';':
2914         if (CopLINE(PL_curcop) < PL_copline)
2915             PL_copline = CopLINE(PL_curcop);
2916         tmp = *s++;
2917         OPERATOR(tmp);
2918     case ')':
2919         tmp = *s++;
2920         s = skipspace(s);
2921         if (*s == '{')
2922             PREBLOCK(tmp);
2923         TERM(tmp);
2924     case ']':
2925         s++;
2926         if (PL_lex_brackets <= 0)
2927             yyerror("Unmatched right square bracket");
2928         else
2929             --PL_lex_brackets;
2930         if (PL_lex_state == LEX_INTERPNORMAL) {
2931             if (PL_lex_brackets == 0) {
2932                 if (*s != '[' && *s != '{' && (*s != '-' || s[1] != '>'))
2933                     PL_lex_state = LEX_INTERPEND;
2934             }
2935         }
2936         TERM(']');
2937     case '{':
2938       leftbracket:
2939         s++;
2940         if (PL_lex_brackets > 100) {
2941             char* newlb = Renew(PL_lex_brackstack, PL_lex_brackets + 1, char);
2942             if (newlb != PL_lex_brackstack) {
2943                 SAVEFREEPV(newlb);
2944                 PL_lex_brackstack = newlb;
2945             }
2946         }
2947         switch (PL_expect) {
2948         case XTERM:
2949             if (PL_lex_formbrack) {
2950                 s--;
2951                 PRETERMBLOCK(DO);
2952             }
2953             if (PL_oldoldbufptr == PL_last_lop)
2954                 PL_lex_brackstack[PL_lex_brackets++] = XTERM;
2955             else
2956                 PL_lex_brackstack[PL_lex_brackets++] = XOPERATOR;
2957             OPERATOR(HASHBRACK);
2958         case XOPERATOR:
2959             while (s < PL_bufend && (*s == ' ' || *s == '\t'))
2960                 s++;
2961             d = s;
2962             PL_tokenbuf[0] = '\0';
2963             if (d < PL_bufend && *d == '-') {
2964                 PL_tokenbuf[0] = '-';
2965                 d++;
2966                 while (d < PL_bufend && (*d == ' ' || *d == '\t'))
2967                     d++;
2968             }
2969             if (d < PL_bufend && isIDFIRST_lazy_if(d,UTF)) {
2970                 d = scan_word(d, PL_tokenbuf + 1, sizeof PL_tokenbuf - 1,
2971                               FALSE, &len);
2972                 while (d < PL_bufend && (*d == ' ' || *d == '\t'))
2973                     d++;
2974                 if (*d == '}') {
2975                     char minus = (PL_tokenbuf[0] == '-');
2976                     s = force_word(s + minus, WORD, FALSE, TRUE, FALSE);
2977                     if (minus)
2978                         force_next('-');
2979                 }
2980             }
2981             /* FALL THROUGH */
2982         case XATTRBLOCK:
2983         case XBLOCK:
2984             PL_lex_brackstack[PL_lex_brackets++] = XSTATE;
2985             PL_expect = XSTATE;
2986             break;
2987         case XATTRTERM:
2988         case XTERMBLOCK:
2989             PL_lex_brackstack[PL_lex_brackets++] = XOPERATOR;
2990             PL_expect = XSTATE;
2991             break;
2992         default: {
2993                 char *t;
2994                 if (PL_oldoldbufptr == PL_last_lop)
2995                     PL_lex_brackstack[PL_lex_brackets++] = XTERM;
2996                 else
2997                     PL_lex_brackstack[PL_lex_brackets++] = XOPERATOR;
2998                 s = skipspace(s);
2999                 if (*s == '}')
3000                     OPERATOR(HASHBRACK);
3001                 /* This hack serves to disambiguate a pair of curlies
3002                  * as being a block or an anon hash.  Normally, expectation
3003                  * determines that, but in cases where we're not in a
3004                  * position to expect anything in particular (like inside
3005                  * eval"") we have to resolve the ambiguity.  This code
3006                  * covers the case where the first term in the curlies is a
3007                  * quoted string.  Most other cases need to be explicitly
3008                  * disambiguated by prepending a `+' before the opening
3009                  * curly in order to force resolution as an anon hash.
3010                  *
3011                  * XXX should probably propagate the outer expectation
3012                  * into eval"" to rely less on this hack, but that could
3013                  * potentially break current behavior of eval"".
3014                  * GSAR 97-07-21
3015                  */
3016                 t = s;
3017                 if (*s == '\'' || *s == '"' || *s == '`') {
3018                     /* common case: get past first string, handling escapes */
3019                     for (t++; t < PL_bufend && *t != *s;)
3020                         if (*t++ == '\\' && (*t == '\\' || *t == *s))
3021                             t++;
3022                     t++;
3023                 }
3024                 else if (*s == 'q') {
3025                     if (++t < PL_bufend
3026                         && (!isALNUM(*t)
3027                             || ((*t == 'q' || *t == 'x') && ++t < PL_bufend
3028                                 && !isALNUM(*t))))
3029                     {
3030                         char *tmps;
3031                         char open, close, term;
3032                         I32 brackets = 1;
3033
3034                         while (t < PL_bufend && isSPACE(*t))
3035                             t++;
3036                         term = *t;
3037                         open = term;
3038                         if (term && (tmps = strchr("([{< )]}> )]}>",term)))
3039                             term = tmps[5];
3040                         close = term;
3041                         if (open == close)
3042                             for (t++; t < PL_bufend; t++) {
3043                                 if (*t == '\\' && t+1 < PL_bufend && open != '\\')
3044                                     t++;
3045                                 else if (*t == open)
3046                                     break;
3047                             }
3048                         else
3049                             for (t++; t < PL_bufend; t++) {
3050                                 if (*t == '\\' && t+1 < PL_bufend)
3051                                     t++;
3052                                 else if (*t == close && --brackets <= 0)
3053                                     break;
3054                                 else if (*t == open)
3055                                     brackets++;
3056                             }
3057                     }
3058                     t++;
3059                 }
3060                 else if (isALNUM_lazy_if(t,UTF)) {
3061                     t += UTF8SKIP(t);
3062                     while (t < PL_bufend && isALNUM_lazy_if(t,UTF))
3063                          t += UTF8SKIP(t);
3064                 }
3065                 while (t < PL_bufend && isSPACE(*t))
3066                     t++;
3067                 /* if comma follows first term, call it an anon hash */
3068                 /* XXX it could be a comma expression with loop modifiers */
3069                 if (t < PL_bufend && ((*t == ',' && (*s == 'q' || !isLOWER(*s)))
3070                                    || (*t == '=' && t[1] == '>')))
3071                     OPERATOR(HASHBRACK);
3072                 if (PL_expect == XREF)
3073                     PL_expect = XTERM;
3074                 else {
3075                     PL_lex_brackstack[PL_lex_brackets-1] = XSTATE;
3076                     PL_expect = XSTATE;
3077                 }
3078             }
3079             break;
3080         }
3081         yylval.ival = CopLINE(PL_curcop);
3082         if (isSPACE(*s) || *s == '#')
3083             PL_copline = NOLINE;   /* invalidate current command line number */
3084         TOKEN('{');
3085     case '}':
3086       rightbracket:
3087         s++;
3088         if (PL_lex_brackets <= 0)
3089             yyerror("Unmatched right curly bracket");
3090         else
3091             PL_expect = (expectation)PL_lex_brackstack[--PL_lex_brackets];
3092         if (PL_lex_brackets < PL_lex_formbrack)
3093             PL_lex_formbrack = 0;
3094         if (PL_lex_state == LEX_INTERPNORMAL) {
3095             if (PL_lex_brackets == 0) {
3096                 if (PL_expect & XFAKEBRACK) {
3097                     PL_expect &= XENUMMASK;
3098                     PL_lex_state = LEX_INTERPEND;
3099                     PL_bufptr = s;
3100                     return yylex();     /* ignore fake brackets */
3101                 }
3102                 if (*s == '-' && s[1] == '>')
3103                     PL_lex_state = LEX_INTERPENDMAYBE;
3104                 else if (*s != '[' && *s != '{')
3105                     PL_lex_state = LEX_INTERPEND;
3106             }
3107         }
3108         if (PL_expect & XFAKEBRACK) {
3109             PL_expect &= XENUMMASK;
3110             PL_bufptr = s;
3111             return yylex();             /* ignore fake brackets */
3112         }
3113         force_next('}');
3114         TOKEN(';');
3115     case '&':
3116         s++;
3117         tmp = *s++;
3118         if (tmp == '&')
3119             AOPERATOR(ANDAND);
3120         s--;
3121         if (PL_expect == XOPERATOR) {
3122             if (ckWARN(WARN_SEMICOLON)
3123                 && isIDFIRST_lazy_if(s,UTF) && PL_bufptr == PL_linestart)
3124             {
3125                 CopLINE_dec(PL_curcop);
3126                 Perl_warner(aTHX_ WARN_SEMICOLON, PL_warn_nosemi);
3127                 CopLINE_inc(PL_curcop);
3128             }
3129             BAop(OP_BIT_AND);
3130         }
3131
3132         s = scan_ident(s - 1, PL_bufend, PL_tokenbuf, sizeof PL_tokenbuf, TRUE);
3133         if (*PL_tokenbuf) {
3134             PL_expect = XOPERATOR;
3135             force_ident(PL_tokenbuf, '&');
3136         }
3137         else
3138             PREREF('&');
3139         yylval.ival = (OPpENTERSUB_AMPER<<8);
3140         TERM('&');
3141
3142     case '|':
3143         s++;
3144         tmp = *s++;
3145         if (tmp == '|')
3146             AOPERATOR(OROR);
3147         s--;
3148         BOop(OP_BIT_OR);
3149     case '=':
3150         s++;
3151         tmp = *s++;
3152         if (tmp == '=')
3153             Eop(OP_EQ);
3154         if (tmp == '>')
3155             OPERATOR(',');
3156         if (tmp == '~')
3157             PMop(OP_MATCH);
3158         if (ckWARN(WARN_SYNTAX) && tmp && isSPACE(*s) && strchr("+-*/%.^&|<",tmp))
3159             Perl_warner(aTHX_ WARN_SYNTAX, "Reversed %c= operator",(int)tmp);
3160         s--;
3161         if (PL_expect == XSTATE && isALPHA(tmp) &&
3162                 (s == PL_linestart+1 || s[-2] == '\n') )
3163         {
3164             if (PL_in_eval && !PL_rsfp) {
3165                 d = PL_bufend;
3166                 while (s < d) {
3167                     if (*s++ == '\n') {
3168                         incline(s);
3169                         if (strnEQ(s,"=cut",4)) {
3170                             s = strchr(s,'\n');
3171                             if (s)
3172                                 s++;
3173                             else
3174                                 s = d;
3175                             incline(s);
3176                             goto retry;
3177                         }
3178                     }
3179                 }
3180                 goto retry;
3181             }
3182             s = PL_bufend;
3183             PL_doextract = TRUE;
3184             goto retry;
3185         }
3186         if (PL_lex_brackets < PL_lex_formbrack) {
3187             char *t;
3188 #ifdef PERL_STRICT_CR
3189             for (t = s; *t == ' ' || *t == '\t'; t++) ;
3190 #else
3191             for (t = s; *t == ' ' || *t == '\t' || *t == '\r'; t++) ;
3192 #endif
3193             if (*t == '\n' || *t == '#') {
3194                 s--;
3195                 PL_expect = XBLOCK;
3196                 goto leftbracket;
3197             }
3198         }
3199         yylval.ival = 0;
3200         OPERATOR(ASSIGNOP);
3201     case '!':
3202         s++;
3203         tmp = *s++;
3204         if (tmp == '=')
3205             Eop(OP_NE);
3206         if (tmp == '~')
3207             PMop(OP_NOT);
3208         s--;
3209         OPERATOR('!');
3210     case '<':
3211         if (PL_expect != XOPERATOR) {
3212             if (s[1] != '<' && !strchr(s,'>'))
3213                 check_uni();
3214             if (s[1] == '<')
3215                 s = scan_heredoc(s);
3216             else
3217                 s = scan_inputsymbol(s);
3218             TERM(sublex_start());
3219         }
3220         s++;
3221         tmp = *s++;
3222         if (tmp == '<')
3223             SHop(OP_LEFT_SHIFT);
3224         if (tmp == '=') {
3225             tmp = *s++;
3226             if (tmp == '>')
3227                 Eop(OP_NCMP);
3228             s--;
3229             Rop(OP_LE);
3230         }
3231         s--;
3232         Rop(OP_LT);
3233     case '>':
3234         s++;
3235         tmp = *s++;
3236         if (tmp == '>')
3237             SHop(OP_RIGHT_SHIFT);
3238         if (tmp == '=')
3239             Rop(OP_GE);
3240         s--;
3241         Rop(OP_GT);
3242
3243     case '$':
3244         CLINE;
3245
3246         if (PL_expect == XOPERATOR) {
3247             if (PL_lex_formbrack && PL_lex_brackets == PL_lex_formbrack) {
3248                 PL_expect = XTERM;
3249                 depcom();
3250                 return ','; /* grandfather non-comma-format format */
3251             }
3252         }
3253
3254         if (s[1] == '#' && (isIDFIRST_lazy_if(s+2,UTF) || strchr("{$:+-", s[2]))) {
3255             PL_tokenbuf[0] = '@';
3256             s = scan_ident(s + 1, PL_bufend, PL_tokenbuf + 1,
3257                            sizeof PL_tokenbuf - 1, FALSE);
3258             if (PL_expect == XOPERATOR)
3259                 no_op("Array length", s);
3260             if (!PL_tokenbuf[1])
3261                 PREREF(DOLSHARP);
3262             PL_expect = XOPERATOR;
3263             PL_pending_ident = '#';
3264             TOKEN(DOLSHARP);
3265         }
3266
3267         PL_tokenbuf[0] = '$';
3268         s = scan_ident(s, PL_bufend, PL_tokenbuf + 1,
3269                        sizeof PL_tokenbuf - 1, FALSE);
3270         if (PL_expect == XOPERATOR)
3271             no_op("Scalar", s);
3272         if (!PL_tokenbuf[1]) {
3273             if (s == PL_bufend)
3274                 yyerror("Final $ should be \\$ or $name");
3275             PREREF('$');
3276         }
3277
3278         /* This kludge not intended to be bulletproof. */
3279         if (PL_tokenbuf[1] == '[' && !PL_tokenbuf[2]) {
3280             yylval.opval = newSVOP(OP_CONST, 0,
3281                                    newSViv((IV)PL_compiling.cop_arybase));
3282             yylval.opval->op_private = OPpCONST_ARYBASE;
3283             TERM(THING);
3284         }
3285
3286         d = s;
3287         tmp = (I32)*s;
3288         if (PL_lex_state == LEX_NORMAL)
3289             s = skipspace(s);
3290
3291         if ((PL_expect != XREF || PL_oldoldbufptr == PL_last_lop) && intuit_more(s)) {
3292             char *t;
3293             if (*s == '[') {
3294                 PL_tokenbuf[0] = '@';
3295                 if (ckWARN(WARN_SYNTAX)) {
3296                     for(t = s + 1;
3297                         isSPACE(*t) || isALNUM_lazy_if(t,UTF) || *t == '$';
3298                         t++) ;
3299                     if (*t++ == ',') {
3300                         PL_bufptr = skipspace(PL_bufptr);
3301                         while (t < PL_bufend && *t != ']')
3302                             t++;
3303                         Perl_warner(aTHX_ WARN_SYNTAX,
3304                                 "Multidimensional syntax %.*s not supported",
3305                                 (t - PL_bufptr) + 1, PL_bufptr);
3306                     }
3307                 }
3308             }
3309             else if (*s == '{') {
3310                 PL_tokenbuf[0] = '%';
3311                 if (ckWARN(WARN_SYNTAX) && strEQ(PL_tokenbuf+1, "SIG") &&
3312                     (t = strchr(s, '}')) && (t = strchr(t, '=')))
3313                 {
3314                     char tmpbuf[sizeof PL_tokenbuf];
3315                     STRLEN len;
3316                     for (t++; isSPACE(*t); t++) ;
3317                     if (isIDFIRST_lazy_if(t,UTF)) {
3318                         t = scan_word(t, tmpbuf, sizeof tmpbuf, TRUE, &len);
3319                         for (; isSPACE(*t); t++) ;
3320                         if (*t == ';' && get_cv(tmpbuf, FALSE))
3321                             Perl_warner(aTHX_ WARN_SYNTAX,
3322                                 "You need to quote \"%s\"", tmpbuf);
3323                     }
3324                 }
3325             }
3326         }
3327
3328         PL_expect = XOPERATOR;
3329         if (PL_lex_state == LEX_NORMAL && isSPACE((char)tmp)) {
3330             bool islop = (PL_last_lop == PL_oldoldbufptr);
3331             if (!islop || PL_last_lop_op == OP_GREPSTART)
3332                 PL_expect = XOPERATOR;
3333             else if (strchr("$@\"'`q", *s))
3334                 PL_expect = XTERM;              /* e.g. print $fh "foo" */
3335             else if (strchr("&*<%", *s) && isIDFIRST_lazy_if(s+1,UTF))
3336                 PL_expect = XTERM;              /* e.g. print $fh &sub */
3337             else if (isIDFIRST_lazy_if(s,UTF)) {
3338                 char tmpbuf[sizeof PL_tokenbuf];
3339                 scan_word(s, tmpbuf, sizeof tmpbuf, TRUE, &len);
3340                 if ((tmp = keyword(tmpbuf, len))) {
3341                     /* binary operators exclude handle interpretations */
3342                     switch (tmp) {
3343                     case -KEY_x:
3344                     case -KEY_eq:
3345                     case -KEY_ne:
3346                     case -KEY_gt:
3347                     case -KEY_lt:
3348                     case -KEY_ge:
3349                     case -KEY_le:
3350                     case -KEY_cmp:
3351                         break;
3352                     default:
3353                         PL_expect = XTERM;      /* e.g. print $fh length() */
3354                         break;
3355                     }
3356                 }
3357                 else {
3358                     GV *gv = gv_fetchpv(tmpbuf, FALSE, SVt_PVCV);
3359                     if (gv && GvCVu(gv))
3360                         PL_expect = XTERM;      /* e.g. print $fh subr() */
3361                 }
3362             }
3363             else if (isDIGIT(*s))
3364                 PL_expect = XTERM;              /* e.g. print $fh 3 */
3365             else if (*s == '.' && isDIGIT(s[1]))
3366                 PL_expect = XTERM;              /* e.g. print $fh .3 */
3367             else if (strchr("/?-+", *s) && !isSPACE(s[1]) && s[1] != '=')
3368                 PL_expect = XTERM;              /* e.g. print $fh -1 */
3369             else if (*s == '<' && s[1] == '<' && !isSPACE(s[2]) && s[2] != '=')
3370                 PL_expect = XTERM;              /* print $fh <<"EOF" */
3371         }
3372         PL_pending_ident = '$';
3373         TOKEN('$');
3374
3375     case '@':
3376         if (PL_expect == XOPERATOR)
3377             no_op("Array", s);
3378         PL_tokenbuf[0] = '@';
3379         s = scan_ident(s, PL_bufend, PL_tokenbuf + 1, sizeof PL_tokenbuf - 1, FALSE);
3380         if (!PL_tokenbuf[1]) {
3381             if (s == PL_bufend)
3382                 yyerror("Final @ should be \\@ or @name");
3383             PREREF('@');
3384         }
3385         if (PL_lex_state == LEX_NORMAL)
3386             s = skipspace(s);
3387         if ((PL_expect != XREF || PL_oldoldbufptr == PL_last_lop) && intuit_more(s)) {
3388             if (*s == '{')
3389                 PL_tokenbuf[0] = '%';
3390
3391             /* Warn about @ where they meant $. */
3392             if (ckWARN(WARN_SYNTAX)) {
3393                 if (*s == '[' || *s == '{') {
3394                     char *t = s + 1;
3395                     while (*t && (isALNUM_lazy_if(t,UTF) || strchr(" \t$#+-'\"", *t)))
3396                         t++;
3397                     if (*t == '}' || *t == ']') {
3398                         t++;
3399                         PL_bufptr = skipspace(PL_bufptr);
3400                         Perl_warner(aTHX_ WARN_SYNTAX,
3401                             "Scalar value %.*s better written as $%.*s",
3402                             t-PL_bufptr, PL_bufptr, t-PL_bufptr-1, PL_bufptr+1);
3403                     }
3404                 }
3405             }
3406         }
3407         PL_pending_ident = '@';
3408         TERM('@');
3409
3410     case '/':                   /* may either be division or pattern */
3411     case '?':                   /* may either be conditional or pattern */
3412         if (PL_expect != XOPERATOR) {
3413             /* Disable warning on "study /blah/" */
3414             if (PL_oldoldbufptr == PL_last_uni 
3415                 && (*PL_last_uni != 's' || s - PL_last_uni < 5 
3416                     || memNE(PL_last_uni, "study", 5)
3417                     || isALNUM_lazy_if(PL_last_uni+5,UTF)))
3418                 check_uni();
3419             s = scan_pat(s,OP_MATCH);
3420             TERM(sublex_start());
3421         }
3422         tmp = *s++;
3423         if (tmp == '/')
3424             Mop(OP_DIVIDE);
3425         OPERATOR(tmp);
3426
3427     case '.':
3428         if (PL_lex_formbrack && PL_lex_brackets == PL_lex_formbrack
3429 #ifdef PERL_STRICT_CR
3430             && s[1] == '\n'
3431 #else
3432             && (s[1] == '\n' || (s[1] == '\r' && s[2] == '\n'))
3433 #endif
3434             && (s == PL_linestart || s[-1] == '\n') )
3435         {
3436             PL_lex_formbrack = 0;
3437             PL_expect = XSTATE;
3438             goto rightbracket;
3439         }
3440         if (PL_expect == XOPERATOR || !isDIGIT(s[1])) {
3441             tmp = *s++;
3442             if (*s == tmp) {
3443                 s++;
3444                 if (*s == tmp) {
3445                     s++;
3446                     yylval.ival = OPf_SPECIAL;
3447                 }
3448                 else
3449                     yylval.ival = 0;
3450                 OPERATOR(DOTDOT);
3451             }
3452             if (PL_expect != XOPERATOR)
3453                 check_uni();
3454             Aop(OP_CONCAT);
3455         }
3456         /* FALL THROUGH */
3457     case '0': case '1': case '2': case '3': case '4':
3458     case '5': case '6': case '7': case '8': case '9':
3459         s = scan_num(s);
3460         if (PL_expect == XOPERATOR)
3461             no_op("Number",s);
3462         TERM(THING);
3463
3464     case '\'':
3465         s = scan_str(s,FALSE,FALSE);
3466         if (PL_expect == XOPERATOR) {
3467             if (PL_lex_formbrack && PL_lex_brackets == PL_lex_formbrack) {
3468                 PL_expect = XTERM;
3469                 depcom();
3470                 return ',';     /* grandfather non-comma-format format */
3471             }
3472             else
3473                 no_op("String",s);
3474         }
3475         if (!s)
3476             missingterm((char*)0);
3477         yylval.ival = OP_CONST;
3478         TERM(sublex_start());
3479
3480     case '"':
3481         s = scan_str(s,FALSE,FALSE);
3482         if (PL_expect == XOPERATOR) {
3483             if (PL_lex_formbrack && PL_lex_brackets == PL_lex_formbrack) {
3484                 PL_expect = XTERM;
3485                 depcom();
3486                 return ',';     /* grandfather non-comma-format format */
3487             }
3488             else
3489                 no_op("String",s);
3490         }
3491         if (!s)
3492             missingterm((char*)0);
3493         yylval.ival = OP_CONST;
3494         for (d = SvPV(PL_lex_stuff, len); len; len--, d++) {
3495             if (*d == '$' || *d == '@' || *d == '\\' || *d & 0x80) {
3496                 yylval.ival = OP_STRINGIFY;
3497                 break;
3498             }
3499         }
3500         TERM(sublex_start());
3501
3502     case '`':
3503         s = scan_str(s,FALSE,FALSE);
3504         if (PL_expect == XOPERATOR)
3505             no_op("Backticks",s);
3506         if (!s)
3507             missingterm((char*)0);
3508         yylval.ival = OP_BACKTICK;
3509         set_csh();
3510         TERM(sublex_start());
3511
3512     case '\\':
3513         s++;
3514         if (ckWARN(WARN_SYNTAX) && PL_lex_inwhat && isDIGIT(*s))
3515             Perl_warner(aTHX_ WARN_SYNTAX,"Can't use \\%c to mean $%c in expression",
3516                         *s, *s);
3517         if (PL_expect == XOPERATOR)
3518             no_op("Backslash",s);
3519         OPERATOR(REFGEN);
3520
3521     case 'v':
3522         if (isDIGIT(s[1]) && PL_expect != XOPERATOR) {
3523             char *start = s;
3524             start++;
3525             start++;
3526             while (isDIGIT(*start) || *start == '_')
3527                 start++;
3528             if (*start == '.' && isDIGIT(start[1])) {
3529                 s = scan_num(s);
3530                 TERM(THING);
3531             }
3532             /* avoid v123abc() or $h{v1}, allow C<print v10;> */
3533             else if (!isALPHA(*start) && (PL_expect == XTERM || PL_expect == XREF)) {
3534                 char c = *start;
3535                 GV *gv;
3536                 *start = '\0';
3537                 gv = gv_fetchpv(s, FALSE, SVt_PVCV);
3538                 *start = c;
3539                 if (!gv) {
3540                     s = scan_num(s);
3541                     TERM(THING);
3542                 }
3543             }
3544         }
3545         goto keylookup;
3546     case 'x':
3547         if (isDIGIT(s[1]) && PL_expect == XOPERATOR) {
3548             s++;
3549             Mop(OP_REPEAT);
3550         }
3551         goto keylookup;
3552
3553     case '_':
3554     case 'a': case 'A':
3555     case 'b': case 'B':
3556     case 'c': case 'C':
3557     case 'd': case 'D':
3558     case 'e': case 'E':
3559     case 'f': case 'F':
3560     case 'g': case 'G':
3561     case 'h': case 'H':
3562     case 'i': case 'I':
3563     case 'j': case 'J':
3564     case 'k': case 'K':
3565     case 'l': case 'L':
3566     case 'm': case 'M':
3567     case 'n': case 'N':
3568     case 'o': case 'O':
3569     case 'p': case 'P':
3570     case 'q': case 'Q':
3571     case 'r': case 'R':
3572     case 's': case 'S':
3573     case 't': case 'T':
3574     case 'u': case 'U':
3575               case 'V':
3576     case 'w': case 'W':
3577               case 'X':
3578     case 'y': case 'Y':
3579     case 'z': case 'Z':
3580
3581       keylookup: {
3582         gv = Nullgv;
3583         gvp = 0;
3584
3585         PL_bufptr = s;
3586         s = scan_word(s, PL_tokenbuf, sizeof PL_tokenbuf, FALSE, &len);
3587
3588         /* Some keywords can be followed by any delimiter, including ':' */
3589         tmp = ((len == 1 && strchr("msyq", PL_tokenbuf[0])) ||
3590                (len == 2 && ((PL_tokenbuf[0] == 't' && PL_tokenbuf[1] == 'r') ||
3591                              (PL_tokenbuf[0] == 'q' &&
3592                               strchr("qwxr", PL_tokenbuf[1])))));
3593
3594         /* x::* is just a word, unless x is "CORE" */
3595         if (!tmp && *s == ':' && s[1] == ':' && strNE(PL_tokenbuf, "CORE"))
3596             goto just_a_word;
3597
3598         d = s;
3599         while (d < PL_bufend && isSPACE(*d))
3600                 d++;    /* no comments skipped here, or s### is misparsed */
3601
3602         /* Is this a label? */
3603         if (!tmp && PL_expect == XSTATE
3604               && d < PL_bufend && *d == ':' && *(d + 1) != ':') {
3605             s = d + 1;
3606             yylval.pval = savepv(PL_tokenbuf);
3607             CLINE;
3608             TOKEN(LABEL);
3609         }
3610
3611         /* Check for keywords */
3612         tmp = keyword(PL_tokenbuf, len);
3613
3614         /* Is this a word before a => operator? */
3615         if (strnEQ(d,"=>",2)) {
3616             CLINE;
3617             yylval.opval = (OP*)newSVOP(OP_CONST, 0, newSVpv(PL_tokenbuf,0));
3618             yylval.opval->op_private = OPpCONST_BARE;
3619             TERM(WORD);
3620         }
3621
3622         if (tmp < 0) {                  /* second-class keyword? */
3623             GV *ogv = Nullgv;   /* override (winner) */
3624             GV *hgv = Nullgv;   /* hidden (loser) */
3625             if (PL_expect != XOPERATOR && (*s != ':' || s[1] != ':')) {
3626                 CV *cv;
3627                 if ((gv = gv_fetchpv(PL_tokenbuf, FALSE, SVt_PVCV)) &&
3628                     (cv = GvCVu(gv)))
3629                 {
3630                     if (GvIMPORTED_CV(gv))
3631                         ogv = gv;
3632                     else if (! CvMETHOD(cv))
3633                         hgv = gv;
3634                 }
3635                 if (!ogv &&
3636                     (gvp = (GV**)hv_fetch(PL_globalstash,PL_tokenbuf,len,FALSE)) &&
3637                     (gv = *gvp) != (GV*)&PL_sv_undef &&
3638                     GvCVu(gv) && GvIMPORTED_CV(gv))
3639                 {
3640                     ogv = gv;
3641                 }
3642             }
3643             if (ogv) {
3644                 tmp = 0;                /* overridden by import or by GLOBAL */
3645             }
3646             else if (gv && !gvp
3647                      && -tmp==KEY_lock  /* XXX generalizable kludge */
3648                      && GvCVu(gv)
3649                      && !hv_fetch(GvHVn(PL_incgv), "Thread.pm", 9, FALSE))
3650             {
3651                 tmp = 0;                /* any sub overrides "weak" keyword */
3652             }
3653             else {                      /* no override */
3654                 tmp = -tmp;
3655                 gv = Nullgv;
3656                 gvp = 0;
3657                 if (ckWARN(WARN_AMBIGUOUS) && hgv
3658                     && tmp != KEY_x && tmp != KEY_CORE) /* never ambiguous */
3659                     Perl_warner(aTHX_ WARN_AMBIGUOUS,
3660                         "Ambiguous call resolved as CORE::%s(), %s",
3661                          GvENAME(hgv), "qualify as such or use &");
3662             }
3663         }
3664
3665       reserved_word:
3666         switch (tmp) {
3667
3668         default:                        /* not a keyword */
3669           just_a_word: {
3670                 SV *sv;
3671                 char lastchar = (PL_bufptr == PL_oldoldbufptr ? 0 : PL_bufptr[-1]);
3672
3673                 /* Get the rest if it looks like a package qualifier */
3674
3675                 if (*s == '\'' || (*s == ':' && s[1] == ':')) {
3676                     STRLEN morelen;
3677                     s = scan_word(s, PL_tokenbuf + len, sizeof PL_tokenbuf - len,
3678                                   TRUE, &morelen);
3679                     if (!morelen)
3680                         Perl_croak(aTHX_ "Bad name after %s%s", PL_tokenbuf,
3681                                 *s == '\'' ? "'" : "::");
3682                     len += morelen;
3683                 }
3684
3685                 if (PL_expect == XOPERATOR) {
3686                     if (PL_bufptr == PL_linestart) {
3687                         CopLINE_dec(PL_curcop);
3688                         Perl_warner(aTHX_ WARN_SEMICOLON, PL_warn_nosemi);
3689                         CopLINE_inc(PL_curcop);
3690                     }
3691                     else
3692                         no_op("Bareword",s);
3693                 }
3694
3695                 /* Look for a subroutine with this name in current package,
3696                    unless name is "Foo::", in which case Foo is a bearword
3697                    (and a package name). */
3698
3699                 if (len > 2 &&
3700                     PL_tokenbuf[len - 2] == ':' && PL_tokenbuf[len - 1] == ':')
3701                 {
3702                     if (ckWARN(WARN_BAREWORD) && ! gv_fetchpv(PL_tokenbuf, FALSE, SVt_PVHV))
3703                         Perl_warner(aTHX_ WARN_BAREWORD, 
3704                             "Bareword \"%s\" refers to nonexistent package",
3705                              PL_tokenbuf);
3706                     len -= 2;
3707                     PL_tokenbuf[len] = '\0';
3708                     gv = Nullgv;
3709                     gvp = 0;
3710                 }
3711                 else {
3712                     len = 0;
3713                     if (!gv)
3714                         gv = gv_fetchpv(PL_tokenbuf, FALSE, SVt_PVCV);
3715                 }
3716
3717                 /* if we saw a global override before, get the right name */
3718
3719                 if (gvp) {
3720                     sv = newSVpvn("CORE::GLOBAL::",14);
3721                     sv_catpv(sv,PL_tokenbuf);
3722                 }
3723                 else
3724                     sv = newSVpv(PL_tokenbuf,0);
3725
3726                 /* Presume this is going to be a bareword of some sort. */
3727
3728                 CLINE;
3729                 yylval.opval = (OP*)newSVOP(OP_CONST, 0, sv);
3730                 yylval.opval->op_private = OPpCONST_BARE;
3731
3732                 /* And if "Foo::", then that's what it certainly is. */
3733
3734                 if (len)
3735                     goto safe_bareword;
3736
3737                 /* See if it's the indirect object for a list operator. */
3738
3739                 if (PL_oldoldbufptr &&
3740                     PL_oldoldbufptr < PL_bufptr &&
3741                     (PL_oldoldbufptr == PL_last_lop
3742                      || PL_oldoldbufptr == PL_last_uni) &&
3743                     /* NO SKIPSPACE BEFORE HERE! */
3744                     (PL_expect == XREF ||
3745                      ((PL_opargs[PL_last_lop_op] >> OASHIFT)& 7) == OA_FILEREF))
3746                 {
3747                     bool immediate_paren = *s == '(';
3748
3749                     /* (Now we can afford to cross potential line boundary.) */
3750                     s = skipspace(s);
3751
3752                     /* Two barewords in a row may indicate method call. */
3753
3754                     if ((isIDFIRST_lazy_if(s,UTF) || *s == '$') && (tmp=intuit_method(s,gv)))
3755                         return tmp;
3756
3757                     /* If not a declared subroutine, it's an indirect object. */
3758                     /* (But it's an indir obj regardless for sort.) */
3759
3760                     if ((PL_last_lop_op == OP_SORT ||
3761                          (!immediate_paren && (!gv || !GvCVu(gv)))) &&
3762                         (PL_last_lop_op != OP_MAPSTART &&
3763                          PL_last_lop_op != OP_GREPSTART))
3764                     {
3765                         PL_expect = (PL_last_lop == PL_oldoldbufptr) ? XTERM : XOPERATOR;
3766                         goto bareword;
3767                     }
3768                 }
3769
3770                 /* If followed by a paren, it's certainly a subroutine. */
3771
3772                 PL_expect = XOPERATOR;
3773                 s = skipspace(s);
3774                 if (*s == '(') {
3775                     CLINE;
3776                     if (gv && GvCVu(gv)) {
3777                         for (d = s + 1; *d == ' ' || *d == '\t'; d++) ;
3778                         if (*d == ')' && (sv = cv_const_sv(GvCV(gv)))) {
3779                             s = d + 1;
3780                             goto its_constant;
3781                         }
3782                     }
3783                     PL_nextval[PL_nexttoke].opval = yylval.opval;
3784                     PL_expect = XOPERATOR;
3785                     force_next(WORD);
3786                     yylval.ival = 0;
3787                     TOKEN('&');
3788                 }
3789
3790                 /* If followed by var or block, call it a method (unless sub) */
3791
3792                 if ((*s == '$' || *s == '{') && (!gv || !GvCVu(gv))) {
3793                     PL_last_lop = PL_oldbufptr;
3794                     PL_last_lop_op = OP_METHOD;
3795                     PREBLOCK(METHOD);
3796                 }
3797
3798                 /* If followed by a bareword, see if it looks like indir obj. */
3799
3800                 if ((isIDFIRST_lazy_if(s,UTF) || *s == '$') && (tmp = intuit_method(s,gv)))
3801                     return tmp;
3802
3803                 /* Not a method, so call it a subroutine (if defined) */
3804
3805                 if (gv && GvCVu(gv)) {
3806                     CV* cv;
3807                     if (lastchar == '-' && ckWARN_d(WARN_AMBIGUOUS))
3808                         Perl_warner(aTHX_ WARN_AMBIGUOUS,
3809                                 "Ambiguous use of -%s resolved as -&%s()",
3810                                 PL_tokenbuf, PL_tokenbuf);
3811                     /* Check for a constant sub */
3812                     cv = GvCV(gv);
3813                     if ((sv = cv_const_sv(cv))) {
3814                   its_constant:
3815                         SvREFCNT_dec(((SVOP*)yylval.opval)->op_sv);
3816                         ((SVOP*)yylval.opval)->op_sv = SvREFCNT_inc(sv);
3817                         yylval.opval->op_private = 0;
3818                         TOKEN(WORD);
3819                     }
3820
3821                     /* Resolve to GV now. */
3822                     op_free(yylval.opval);
3823                     yylval.opval = newCVREF(0, newGVOP(OP_GV, 0, gv));
3824                     yylval.opval->op_private |= OPpENTERSUB_NOPAREN;
3825                     PL_last_lop = PL_oldbufptr;
3826                     PL_last_lop_op = OP_ENTERSUB;
3827                     /* Is there a prototype? */
3828                     if (SvPOK(cv)) {
3829                         STRLEN len;
3830                         char *proto = SvPV((SV*)cv, len);
3831                         if (!len)
3832                             TERM(FUNC0SUB);
3833                         if (strEQ(proto, "$"))
3834                             OPERATOR(UNIOPSUB);
3835                         if (*proto == '&' && *s == '{') {
3836                             sv_setpv(PL_subname,"__ANON__");
3837                             PREBLOCK(LSTOPSUB);
3838                         }
3839                     }
3840                     PL_nextval[PL_nexttoke].opval = yylval.opval;
3841                     PL_expect = XTERM;
3842                     force_next(WORD);
3843                     TOKEN(NOAMP);
3844                 }
3845
3846                 /* Call it a bare word */
3847
3848                 if (PL_hints & HINT_STRICT_SUBS)
3849                     yylval.opval->op_private |= OPpCONST_STRICT;
3850                 else {
3851                 bareword:
3852                     if (ckWARN(WARN_RESERVED)) {
3853                         if (lastchar != '-') {
3854                             for (d = PL_tokenbuf; *d && isLOWER(*d); d++) ;
3855                             if (!*d)
3856                                 Perl_warner(aTHX_ WARN_RESERVED, PL_warn_reserved,
3857                                        PL_tokenbuf);
3858                         }
3859                     }
3860                 }
3861
3862             safe_bareword:
3863                 if (lastchar && strchr("*%&", lastchar) && ckWARN_d(WARN_AMBIGUOUS)) {
3864                     Perl_warner(aTHX_ WARN_AMBIGUOUS,
3865                         "Operator or semicolon missing before %c%s",
3866                         lastchar, PL_tokenbuf);
3867                     Perl_warner(aTHX_ WARN_AMBIGUOUS,
3868                         "Ambiguous use of %c resolved as operator %c",
3869                         lastchar, lastchar);
3870                 }
3871                 TOKEN(WORD);
3872             }
3873
3874         case KEY___FILE__:
3875             yylval.opval = (OP*)newSVOP(OP_CONST, 0,
3876                                         newSVpv(CopFILE(PL_curcop),0));
3877             TERM(THING);
3878
3879         case KEY___LINE__:
3880             yylval.opval = (OP*)newSVOP(OP_CONST, 0,
3881                                     Perl_newSVpvf(aTHX_ "%"IVdf, (IV)CopLINE(PL_curcop)));
3882             TERM(THING);
3883
3884         case KEY___PACKAGE__:
3885             yylval.opval = (OP*)newSVOP(OP_CONST, 0,
3886                                         (PL_curstash
3887                                          ? newSVsv(PL_curstname)
3888                                          : &PL_sv_undef));
3889             TERM(THING);
3890
3891         case KEY___DATA__:
3892         case KEY___END__: {
3893             GV *gv;
3894
3895             /*SUPPRESS 560*/
3896             if (PL_rsfp && (!PL_in_eval || PL_tokenbuf[2] == 'D')) {
3897                 char *pname = "main";
3898                 if (PL_tokenbuf[2] == 'D')
3899                     pname = HvNAME(PL_curstash ? PL_curstash : PL_defstash);
3900                 gv = gv_fetchpv(Perl_form(aTHX_ "%s::DATA", pname), TRUE, SVt_PVIO);
3901                 GvMULTI_on(gv);
3902                 if (!GvIO(gv))
3903                     GvIOp(gv) = newIO();
3904                 IoIFP(GvIOp(gv)) = PL_rsfp;
3905 #if defined(HAS_FCNTL) && defined(F_SETFD)
3906                 {
3907                     int fd = PerlIO_fileno(PL_rsfp);
3908                     fcntl(fd,F_SETFD,fd >= 3);
3909                 }
3910 #endif
3911                 /* Mark this internal pseudo-handle as clean */
3912                 IoFLAGS(GvIOp(gv)) |= IOf_UNTAINT;
3913                 if (PL_preprocess)
3914                     IoTYPE(GvIOp(gv)) = '|';
3915                 else if ((PerlIO*)PL_rsfp == PerlIO_stdin())
3916                     IoTYPE(GvIOp(gv)) = '-';
3917                 else
3918                     IoTYPE(GvIOp(gv)) = '<';
3919 #if defined(WIN32) && !defined(PERL_TEXTMODE_SCRIPTS)
3920                 /* if the script was opened in binmode, we need to revert
3921                  * it to text mode for compatibility; but only iff it has CRs
3922                  * XXX this is a questionable hack at best. */
3923                 if (PL_bufend-PL_bufptr > 2
3924                     && PL_bufend[-1] == '\n' && PL_bufend[-2] == '\r')
3925                 {
3926                     Off_t loc = 0;
3927                     if (IoTYPE(GvIOp(gv)) == '<') {
3928                         loc = PerlIO_tell(PL_rsfp);
3929                         (void)PerlIO_seek(PL_rsfp, 0L, 0);
3930                     }
3931                     if (PerlLIO_setmode(PerlIO_fileno(PL_rsfp), O_TEXT) != -1) {
3932 #if defined(__BORLANDC__)
3933                         /* XXX see note in do_binmode() */
3934                         ((FILE*)PL_rsfp)->flags |= _F_BIN;
3935 #endif
3936                         if (loc > 0)
3937                             PerlIO_seek(PL_rsfp, loc, 0);
3938                     }
3939                 }
3940 #endif
3941                 PL_rsfp = Nullfp;
3942             }
3943             goto fake_eof;
3944         }
3945
3946         case KEY_AUTOLOAD:
3947         case KEY_DESTROY:
3948         case KEY_BEGIN:
3949         case KEY_CHECK:
3950         case KEY_INIT:
3951         case KEY_END:
3952             if (PL_expect == XSTATE) {
3953                 s = PL_bufptr;
3954                 goto really_sub;
3955             }
3956             goto just_a_word;
3957
3958         case KEY_CORE:
3959             if (*s == ':' && s[1] == ':') {
3960                 s += 2;
3961                 d = s;
3962                 s = scan_word(s, PL_tokenbuf, sizeof PL_tokenbuf, FALSE, &len);
3963                 if (!(tmp = keyword(PL_tokenbuf, len)))
3964                     Perl_croak(aTHX_ "CORE::%s is not a keyword", PL_tokenbuf);
3965                 if (tmp < 0)
3966                     tmp = -tmp;
3967                 goto reserved_word;
3968             }
3969             goto just_a_word;
3970
3971         case KEY_abs:
3972             UNI(OP_ABS);
3973
3974         case KEY_alarm:
3975             UNI(OP_ALARM);
3976
3977         case KEY_accept:
3978             LOP(OP_ACCEPT,XTERM);
3979
3980         case KEY_and:
3981             OPERATOR(ANDOP);
3982
3983         case KEY_atan2:
3984             LOP(OP_ATAN2,XTERM);
3985
3986         case KEY_bind:
3987             LOP(OP_BIND,XTERM);
3988
3989         case KEY_binmode:
3990             LOP(OP_BINMODE,XTERM);
3991
3992         case KEY_bless:
3993             LOP(OP_BLESS,XTERM);
3994
3995         case KEY_chop:
3996             UNI(OP_CHOP);
3997
3998         case KEY_continue:
3999             PREBLOCK(CONTINUE);
4000
4001         case KEY_chdir:
4002             (void)gv_fetchpv("ENV",TRUE, SVt_PVHV);     /* may use HOME */
4003             UNI(OP_CHDIR);
4004
4005         case KEY_close:
4006             UNI(OP_CLOSE);
4007
4008         case KEY_closedir:
4009             UNI(OP_CLOSEDIR);
4010
4011         case KEY_cmp:
4012             Eop(OP_SCMP);
4013
4014         case KEY_caller:
4015             UNI(OP_CALLER);
4016
4017         case KEY_crypt:
4018 #ifdef FCRYPT
4019             if (!PL_cryptseen) {
4020                 PL_cryptseen = TRUE;
4021                 init_des();
4022             }
4023 #endif
4024             LOP(OP_CRYPT,XTERM);
4025
4026         case KEY_chmod:
4027             if (ckWARN(WARN_CHMOD)) {
4028                 for (d = s; d < PL_bufend && (isSPACE(*d) || *d == '('); d++) ;
4029                 if (*d != '0' && isDIGIT(*d))
4030                     Perl_warner(aTHX_ WARN_CHMOD,
4031                                 "chmod() mode argument is missing initial 0");
4032             }
4033             LOP(OP_CHMOD,XTERM);
4034
4035         case KEY_chown:
4036             LOP(OP_CHOWN,XTERM);
4037
4038         case KEY_connect:
4039             LOP(OP_CONNECT,XTERM);
4040
4041         case KEY_chr:
4042             UNI(OP_CHR);
4043
4044         case KEY_cos:
4045             UNI(OP_COS);
4046
4047         case KEY_chroot:
4048             UNI(OP_CHROOT);
4049
4050         case KEY_do:
4051             s = skipspace(s);
4052             if (*s == '{')
4053                 PRETERMBLOCK(DO);
4054             if (*s != '\'')
4055                 s = force_word(s,WORD,FALSE,TRUE,FALSE);
4056             OPERATOR(DO);
4057
4058         case KEY_die:
4059             PL_hints |= HINT_BLOCK_SCOPE;
4060             LOP(OP_DIE,XTERM);
4061
4062         case KEY_defined:
4063             UNI(OP_DEFINED);
4064
4065         case KEY_delete:
4066             UNI(OP_DELETE);
4067
4068         case KEY_dbmopen:
4069             gv_fetchpv("AnyDBM_File::ISA", GV_ADDMULTI, SVt_PVAV);
4070             LOP(OP_DBMOPEN,XTERM);
4071
4072         case KEY_dbmclose:
4073             UNI(OP_DBMCLOSE);
4074
4075         case KEY_dump:
4076             s = force_word(s,WORD,TRUE,FALSE,FALSE);
4077             LOOPX(OP_DUMP);
4078
4079         case KEY_else:
4080             PREBLOCK(ELSE);
4081
4082         case KEY_elsif:
4083             yylval.ival = CopLINE(PL_curcop);
4084             OPERATOR(ELSIF);
4085
4086         case KEY_eq:
4087             Eop(OP_SEQ);
4088
4089         case KEY_exists:
4090             UNI(OP_EXISTS);
4091             
4092         case KEY_exit:
4093             UNI(OP_EXIT);
4094
4095         case KEY_eval:
4096             s = skipspace(s);
4097             PL_expect = (*s == '{') ? XTERMBLOCK : XTERM;
4098             UNIBRACK(OP_ENTEREVAL);
4099
4100         case KEY_eof:
4101             UNI(OP_EOF);
4102
4103         case KEY_exp:
4104             UNI(OP_EXP);
4105
4106         case KEY_each:
4107             UNI(OP_EACH);
4108
4109         case KEY_exec:
4110             set_csh();
4111             LOP(OP_EXEC,XREF);
4112
4113         case KEY_endhostent:
4114             FUN0(OP_EHOSTENT);
4115
4116         case KEY_endnetent:
4117             FUN0(OP_ENETENT);
4118
4119         case KEY_endservent:
4120             FUN0(OP_ESERVENT);
4121
4122         case KEY_endprotoent:
4123             FUN0(OP_EPROTOENT);
4124
4125         case KEY_endpwent:
4126             FUN0(OP_EPWENT);
4127
4128         case KEY_endgrent:
4129             FUN0(OP_EGRENT);
4130
4131         case KEY_for:
4132         case KEY_foreach:
4133             yylval.ival = CopLINE(PL_curcop);
4134             s = skipspace(s);
4135             if (PL_expect == XSTATE && isIDFIRST_lazy_if(s,UTF)) {
4136                 char *p = s;
4137                 if ((PL_bufend - p) >= 3 &&
4138                     strnEQ(p, "my", 2) && isSPACE(*(p + 2)))
4139                     p += 2;
4140                 else if ((PL_bufend - p) >= 4 &&
4141                     strnEQ(p, "our", 3) && isSPACE(*(p + 3)))
4142                     p += 3;
4143                 p = skipspace(p);
4144                 if (isIDFIRST_lazy_if(p,UTF)) {
4145                     p = scan_ident(p, PL_bufend,
4146                         PL_tokenbuf, sizeof PL_tokenbuf, TRUE);
4147                     p = skipspace(p);
4148                 }
4149                 if (*p != '$')
4150                     Perl_croak(aTHX_ "Missing $ on loop variable");
4151             }
4152             OPERATOR(FOR);
4153
4154         case KEY_formline:
4155             LOP(OP_FORMLINE,XTERM);
4156
4157         case KEY_fork:
4158             FUN0(OP_FORK);
4159
4160         case KEY_fcntl:
4161             LOP(OP_FCNTL,XTERM);
4162
4163         case KEY_fileno:
4164             UNI(OP_FILENO);
4165
4166         case KEY_flock:
4167             LOP(OP_FLOCK,XTERM);
4168
4169         case KEY_gt:
4170             Rop(OP_SGT);
4171
4172         case KEY_ge:
4173             Rop(OP_SGE);
4174
4175         case KEY_grep:
4176             LOP(OP_GREPSTART, XREF);
4177
4178         case KEY_goto:
4179             s = force_word(s,WORD,TRUE,FALSE,FALSE);
4180             LOOPX(OP_GOTO);
4181
4182         case KEY_gmtime:
4183             UNI(OP_GMTIME);
4184
4185         case KEY_getc:
4186             UNI(OP_GETC);
4187
4188         case KEY_getppid:
4189             FUN0(OP_GETPPID);
4190
4191         case KEY_getpgrp:
4192             UNI(OP_GETPGRP);
4193
4194         case KEY_getpriority:
4195             LOP(OP_GETPRIORITY,XTERM);
4196
4197         case KEY_getprotobyname:
4198             UNI(OP_GPBYNAME);
4199
4200         case KEY_getprotobynumber:
4201             LOP(OP_GPBYNUMBER,XTERM);
4202
4203         case KEY_getprotoent:
4204             FUN0(OP_GPROTOENT);
4205
4206         case KEY_getpwent:
4207             FUN0(OP_GPWENT);
4208
4209         case KEY_getpwnam:
4210             UNI(OP_GPWNAM);
4211
4212         case KEY_getpwuid:
4213             UNI(OP_GPWUID);
4214
4215         case KEY_getpeername:
4216             UNI(OP_GETPEERNAME);
4217
4218         case KEY_gethostbyname:
4219             UNI(OP_GHBYNAME);
4220
4221         case KEY_gethostbyaddr:
4222             LOP(OP_GHBYADDR,XTERM);
4223
4224         case KEY_gethostent:
4225             FUN0(OP_GHOSTENT);
4226
4227         case KEY_getnetbyname:
4228             UNI(OP_GNBYNAME);
4229
4230         case KEY_getnetbyaddr:
4231             LOP(OP_GNBYADDR,XTERM);
4232
4233         case KEY_getnetent:
4234             FUN0(OP_GNETENT);
4235
4236         case KEY_getservbyname:
4237             LOP(OP_GSBYNAME,XTERM);
4238
4239         case KEY_getservbyport:
4240             LOP(OP_GSBYPORT,XTERM);
4241
4242         case KEY_getservent:
4243             FUN0(OP_GSERVENT);
4244
4245         case KEY_getsockname:
4246             UNI(OP_GETSOCKNAME);
4247
4248         case KEY_getsockopt:
4249             LOP(OP_GSOCKOPT,XTERM);
4250
4251         case KEY_getgrent:
4252             FUN0(OP_GGRENT);
4253
4254         case KEY_getgrnam:
4255             UNI(OP_GGRNAM);
4256
4257         case KEY_getgrgid:
4258             UNI(OP_GGRGID);
4259
4260         case KEY_getlogin:
4261             FUN0(OP_GETLOGIN);
4262
4263         case KEY_glob:
4264             set_csh();
4265             LOP(OP_GLOB,XTERM);
4266
4267         case KEY_hex:
4268             UNI(OP_HEX);
4269
4270         case KEY_if:
4271             yylval.ival = CopLINE(PL_curcop);
4272             OPERATOR(IF);
4273
4274         case KEY_index:
4275             LOP(OP_INDEX,XTERM);
4276
4277         case KEY_int:
4278             UNI(OP_INT);
4279
4280         case KEY_ioctl:
4281             LOP(OP_IOCTL,XTERM);
4282
4283         case KEY_join:
4284             LOP(OP_JOIN,XTERM);
4285
4286         case KEY_keys:
4287             UNI(OP_KEYS);
4288
4289         case KEY_kill:
4290             LOP(OP_KILL,XTERM);
4291
4292         case KEY_last:
4293             s = force_word(s,WORD,TRUE,FALSE,FALSE);
4294             LOOPX(OP_LAST);
4295             
4296         case KEY_lc:
4297             UNI(OP_LC);
4298
4299         case KEY_lcfirst:
4300             UNI(OP_LCFIRST);
4301
4302         case KEY_local:
4303             yylval.ival = 0;
4304             OPERATOR(LOCAL);
4305
4306         case KEY_length:
4307             UNI(OP_LENGTH);
4308
4309         case KEY_lt:
4310             Rop(OP_SLT);
4311
4312         case KEY_le:
4313             Rop(OP_SLE);
4314
4315         case KEY_localtime:
4316             UNI(OP_LOCALTIME);
4317
4318         case KEY_log:
4319             UNI(OP_LOG);
4320
4321         case KEY_link:
4322             LOP(OP_LINK,XTERM);
4323
4324         case KEY_listen:
4325             LOP(OP_LISTEN,XTERM);
4326
4327         case KEY_lock:
4328             UNI(OP_LOCK);
4329
4330         case KEY_lstat:
4331             UNI(OP_LSTAT);
4332
4333         case KEY_m:
4334             s = scan_pat(s,OP_MATCH);
4335             TERM(sublex_start());
4336
4337         case KEY_map:
4338             LOP(OP_MAPSTART, XREF);
4339
4340         case KEY_mkdir:
4341             LOP(OP_MKDIR,XTERM);
4342
4343         case KEY_msgctl:
4344             LOP(OP_MSGCTL,XTERM);
4345
4346         case KEY_msgget:
4347             LOP(OP_MSGGET,XTERM);
4348
4349         case KEY_msgrcv:
4350             LOP(OP_MSGRCV,XTERM);
4351
4352         case KEY_msgsnd:
4353             LOP(OP_MSGSND,XTERM);
4354
4355         case KEY_our:
4356         case KEY_my:
4357             PL_in_my = tmp;
4358             s = skipspace(s);
4359             if (isIDFIRST_lazy_if(s,UTF)) {
4360                 s = scan_word(s, PL_tokenbuf, sizeof PL_tokenbuf, TRUE, &len);
4361                 if (len == 3 && strnEQ(PL_tokenbuf, "sub", 3))
4362                     goto really_sub;
4363                 PL_in_my_stash = gv_stashpv(PL_tokenbuf, FALSE);
4364                 if (!PL_in_my_stash) {
4365                     char tmpbuf[1024];
4366                     PL_bufptr = s;
4367                     sprintf(tmpbuf, "No such class %.1000s", PL_tokenbuf);
4368                     yyerror(tmpbuf);
4369                 }
4370             }
4371             yylval.ival = 1;
4372             OPERATOR(MY);
4373
4374         case KEY_next:
4375             s = force_word(s,WORD,TRUE,FALSE,FALSE);
4376             LOOPX(OP_NEXT);
4377
4378         case KEY_ne:
4379             Eop(OP_SNE);
4380
4381         case KEY_no:
4382             if (PL_expect != XSTATE)
4383                 yyerror("\"no\" not allowed in expression");
4384             s = force_word(s,WORD,FALSE,TRUE,FALSE);
4385             s = force_version(s);
4386             yylval.ival = 0;
4387             OPERATOR(USE);
4388
4389         case KEY_not:
4390             if (*s == '(' || (s = skipspace(s), *s == '('))
4391                 FUN1(OP_NOT);
4392             else
4393                 OPERATOR(NOTOP);
4394
4395         case KEY_open:
4396             s = skipspace(s);
4397             if (isIDFIRST_lazy_if(s,UTF)) {
4398                 char *t;
4399                 for (d = s; isALNUM_lazy_if(d,UTF); d++) ;
4400                 t = skipspace(d);
4401                 if (strchr("|&*+-=!?:.", *t) && ckWARN_d(WARN_PRECEDENCE))
4402                     Perl_warner(aTHX_ WARN_PRECEDENCE,
4403                            "Precedence problem: open %.*s should be open(%.*s)",
4404                             d-s,s, d-s,s);
4405             }
4406            &