PageRenderTime 327ms CodeModel.GetById 181ms app.highlight 19ms RepoModel.GetById 122ms app.codeStats 0ms

/js/lib/Socket.IO-node/support/expresso/deps/jscoverage/js/jsscan.h

http://github.com/onedayitwillmake/RealtimeMultiplayerNodeJs
C++ Header | 389 lines | 236 code | 44 blank | 109 comment | 11 complexity | 37ab25a4f6cdf0353a1d00d19c9cf481 MD5 | raw file
  1/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
  2 *
  3 * ***** BEGIN LICENSE BLOCK *****
  4 * Version: MPL 1.1/GPL 2.0/LGPL 2.1
  5 *
  6 * The contents of this file are subject to the Mozilla Public License Version
  7 * 1.1 (the "License"); you may not use this file except in compliance with
  8 * the License. You may obtain a copy of the License at
  9 * http://www.mozilla.org/MPL/
 10 *
 11 * Software distributed under the License is distributed on an "AS IS" basis,
 12 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
 13 * for the specific language governing rights and limitations under the
 14 * License.
 15 *
 16 * The Original Code is Mozilla Communicator client code, released
 17 * March 31, 1998.
 18 *
 19 * The Initial Developer of the Original Code is
 20 * Netscape Communications Corporation.
 21 * Portions created by the Initial Developer are Copyright (C) 1998
 22 * the Initial Developer. All Rights Reserved.
 23 *
 24 * Contributor(s):
 25 *
 26 * Alternatively, the contents of this file may be used under the terms of
 27 * either of the GNU General Public License Version 2 or later (the "GPL"),
 28 * or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
 29 * in which case the provisions of the GPL or the LGPL are applicable instead
 30 * of those above. If you wish to allow use of your version of this file only
 31 * under the terms of either the GPL or the LGPL, and not to allow others to
 32 * use your version of this file under the terms of the MPL, indicate your
 33 * decision by deleting the provisions above and replace them with the notice
 34 * and other provisions required by the GPL or the LGPL. If you do not delete
 35 * the provisions above, a recipient may use your version of this file under
 36 * the terms of any one of the MPL, the GPL or the LGPL.
 37 *
 38 * ***** END LICENSE BLOCK ***** */
 39
 40#ifndef jsscan_h___
 41#define jsscan_h___
 42/*
 43 * JS lexical scanner interface.
 44 */
 45#include <stddef.h>
 46#include <stdio.h>
 47#include "jsversion.h"
 48#include "jsopcode.h"
 49#include "jsprvtd.h"
 50#include "jspubtd.h"
 51
 52JS_BEGIN_EXTERN_C
 53
 54#define JS_KEYWORD(keyword, type, op, version) \
 55    extern const char js_##keyword##_str[];
 56#include "jskeyword.tbl"
 57#undef JS_KEYWORD
 58
 59typedef enum JSTokenType {
 60    TOK_ERROR = -1,                     /* well-known as the only code < EOF */
 61    TOK_EOF = 0,                        /* end of file */
 62    TOK_EOL = 1,                        /* end of line */
 63    TOK_SEMI = 2,                       /* semicolon */
 64    TOK_COMMA = 3,                      /* comma operator */
 65    TOK_ASSIGN = 4,                     /* assignment ops (= += -= etc.) */
 66    TOK_HOOK = 5, TOK_COLON = 6,        /* conditional (?:) */
 67    TOK_OR = 7,                         /* logical or (||) */
 68    TOK_AND = 8,                        /* logical and (&&) */
 69    TOK_BITOR = 9,                      /* bitwise-or (|) */
 70    TOK_BITXOR = 10,                    /* bitwise-xor (^) */
 71    TOK_BITAND = 11,                    /* bitwise-and (&) */
 72    TOK_EQOP = 12,                      /* equality ops (== !=) */
 73    TOK_RELOP = 13,                     /* relational ops (< <= > >=) */
 74    TOK_SHOP = 14,                      /* shift ops (<< >> >>>) */
 75    TOK_PLUS = 15,                      /* plus */
 76    TOK_MINUS = 16,                     /* minus */
 77    TOK_STAR = 17, TOK_DIVOP = 18,      /* multiply/divide ops (* / %) */
 78    TOK_UNARYOP = 19,                   /* unary prefix operator */
 79    TOK_INC = 20, TOK_DEC = 21,         /* increment/decrement (++ --) */
 80    TOK_DOT = 22,                       /* member operator (.) */
 81    TOK_LB = 23, TOK_RB = 24,           /* left and right brackets */
 82    TOK_LC = 25, TOK_RC = 26,           /* left and right curlies (braces) */
 83    TOK_LP = 27, TOK_RP = 28,           /* left and right parentheses */
 84    TOK_NAME = 29,                      /* identifier */
 85    TOK_NUMBER = 30,                    /* numeric constant */
 86    TOK_STRING = 31,                    /* string constant */
 87    TOK_REGEXP = 32,                    /* RegExp constant */
 88    TOK_PRIMARY = 33,                   /* true, false, null, this, super */
 89    TOK_FUNCTION = 34,                  /* function keyword */
 90    TOK_IF = 35,                        /* if keyword */
 91    TOK_ELSE = 36,                      /* else keyword */
 92    TOK_SWITCH = 37,                    /* switch keyword */
 93    TOK_CASE = 38,                      /* case keyword */
 94    TOK_DEFAULT = 39,                   /* default keyword */
 95    TOK_WHILE = 40,                     /* while keyword */
 96    TOK_DO = 41,                        /* do keyword */
 97    TOK_FOR = 42,                       /* for keyword */
 98    TOK_BREAK = 43,                     /* break keyword */
 99    TOK_CONTINUE = 44,                  /* continue keyword */
100    TOK_IN = 45,                        /* in keyword */
101    TOK_VAR = 46,                       /* var keyword */
102    TOK_WITH = 47,                      /* with keyword */
103    TOK_RETURN = 48,                    /* return keyword */
104    TOK_NEW = 49,                       /* new keyword */
105    TOK_DELETE = 50,                    /* delete keyword */
106    TOK_DEFSHARP = 51,                  /* #n= for object/array initializers */
107    TOK_USESHARP = 52,                  /* #n# for object/array initializers */
108    TOK_TRY = 53,                       /* try keyword */
109    TOK_CATCH = 54,                     /* catch keyword */
110    TOK_FINALLY = 55,                   /* finally keyword */
111    TOK_THROW = 56,                     /* throw keyword */
112    TOK_INSTANCEOF = 57,                /* instanceof keyword */
113    TOK_DEBUGGER = 58,                  /* debugger keyword */
114    TOK_XMLSTAGO = 59,                  /* XML start tag open (<) */
115    TOK_XMLETAGO = 60,                  /* XML end tag open (</) */
116    TOK_XMLPTAGC = 61,                  /* XML point tag close (/>) */
117    TOK_XMLTAGC = 62,                   /* XML start or end tag close (>) */
118    TOK_XMLNAME = 63,                   /* XML start-tag non-final fragment */
119    TOK_XMLATTR = 64,                   /* XML quoted attribute value */
120    TOK_XMLSPACE = 65,                  /* XML whitespace */
121    TOK_XMLTEXT = 66,                   /* XML text */
122    TOK_XMLCOMMENT = 67,                /* XML comment */
123    TOK_XMLCDATA = 68,                  /* XML CDATA section */
124    TOK_XMLPI = 69,                     /* XML processing instruction */
125    TOK_AT = 70,                        /* XML attribute op (@) */
126    TOK_DBLCOLON = 71,                  /* namespace qualified name op (::) */
127    TOK_ANYNAME = 72,                   /* XML AnyName singleton (*) */
128    TOK_DBLDOT = 73,                    /* XML descendant op (..) */
129    TOK_FILTER = 74,                    /* XML filtering predicate op (.()) */
130    TOK_XMLELEM = 75,                   /* XML element node type (no token) */
131    TOK_XMLLIST = 76,                   /* XML list node type (no token) */
132    TOK_YIELD = 77,                     /* yield from generator function */
133    TOK_ARRAYCOMP = 78,                 /* array comprehension initialiser */
134    TOK_ARRAYPUSH = 79,                 /* array push within comprehension */
135    TOK_LEXICALSCOPE = 80,              /* block scope AST node label */
136    TOK_LET = 81,                       /* let keyword */
137    TOK_SEQ = 82,                       /* synthetic sequence of statements,
138                                           not a block */
139    TOK_FORHEAD = 83,                   /* head of for(;;)-style loop */
140    TOK_RESERVED,                       /* reserved keywords */
141    TOK_LIMIT                           /* domain size */
142} JSTokenType;
143
144#define IS_PRIMARY_TOKEN(tt) \
145    ((uintN)((tt) - TOK_NAME) <= (uintN)(TOK_PRIMARY - TOK_NAME))
146
147#define TOKEN_TYPE_IS_XML(tt) \
148    (tt == TOK_AT || tt == TOK_DBLCOLON || tt == TOK_ANYNAME)
149
150#if JS_HAS_BLOCK_SCOPE
151# define TOKEN_TYPE_IS_DECL(tt) ((tt) == TOK_VAR || (tt) == TOK_LET)
152#else
153# define TOKEN_TYPE_IS_DECL(tt) ((tt) == TOK_VAR)
154#endif
155
156struct JSStringBuffer {
157    jschar      *base;
158    jschar      *limit;         /* length limit for quick bounds check */
159    jschar      *ptr;           /* slot for next non-NUL char to store */
160    void        *data;
161    JSBool      (*grow)(JSStringBuffer *sb, size_t newlength);
162    void        (*free)(JSStringBuffer *sb);
163};
164
165#define STRING_BUFFER_ERROR_BASE        ((jschar *) 1)
166#define STRING_BUFFER_OK(sb)            ((sb)->base != STRING_BUFFER_ERROR_BASE)
167#define STRING_BUFFER_OFFSET(sb)        ((sb)->ptr -(sb)->base)
168
169extern void
170js_InitStringBuffer(JSStringBuffer *sb);
171
172extern void
173js_FinishStringBuffer(JSStringBuffer *sb);
174
175extern void
176js_AppendChar(JSStringBuffer *sb, jschar c);
177
178extern void
179js_RepeatChar(JSStringBuffer *sb, jschar c, uintN count);
180
181extern void
182js_AppendCString(JSStringBuffer *sb, const char *asciiz);
183
184extern void
185js_AppendUCString(JSStringBuffer *sb, const jschar *buf, uintN len);
186
187extern void
188js_AppendJSString(JSStringBuffer *sb, JSString *str);
189
190struct JSTokenPtr {
191    uint16              index;          /* index of char in physical line */
192    uint16              lineno;         /* physical line number */
193};
194
195struct JSTokenPos {
196    JSTokenPtr          begin;          /* first character and line of token */
197    JSTokenPtr          end;            /* index 1 past last char, last line */
198};
199
200struct JSToken {
201    JSTokenType         type;           /* char value or above enumerator */
202    JSTokenPos          pos;            /* token position in file */
203    jschar              *ptr;           /* beginning of token in line buffer */
204    union {
205        struct {                        /* name or string literal */
206            JSOp        op;             /* operator, for minimal parser */
207            JSAtom      *atom;          /* atom table entry */
208        } s;
209        uintN           reflags;        /* regexp flags, use tokenbuf to access
210                                           regexp chars */
211        struct {                        /* atom pair, for XML PIs */
212            JSAtom      *atom2;         /* auxiliary atom table entry */
213            JSAtom      *atom;          /* main atom table entry */
214        } p;
215        jsdouble        dval;           /* floating point number */
216    } u;
217};
218
219#define t_op            u.s.op
220#define t_reflags       u.reflags
221#define t_atom          u.s.atom
222#define t_atom2         u.p.atom2
223#define t_dval          u.dval
224
225typedef struct JSTokenBuf {
226    jschar              *base;          /* base of line or stream buffer */
227    jschar              *limit;         /* limit for quick bounds check */
228    jschar              *ptr;           /* next char to get, or slot to use */
229} JSTokenBuf;
230
231#define JS_LINE_LIMIT   256             /* logical line buffer size limit --
232                                           physical line length is unlimited */
233#define NTOKENS         4               /* 1 current + 2 lookahead, rounded */
234#define NTOKENS_MASK    (NTOKENS-1)     /* to power of 2 to avoid divmod by 3 */
235
236struct JSTokenStream {
237    JSToken             tokens[NTOKENS];/* circular token buffer */
238    uintN               cursor;         /* index of last parsed token */
239    uintN               lookahead;      /* count of lookahead tokens */
240    uintN               lineno;         /* current line number */
241    uintN               ungetpos;       /* next free char slot in ungetbuf */
242    jschar              ungetbuf[6];    /* at most 6, for \uXXXX lookahead */
243    uintN               flags;          /* flags -- see below */
244    ptrdiff_t           linelen;        /* physical linebuf segment length */
245    ptrdiff_t           linepos;        /* linebuf offset in physical line */
246    JSTokenBuf          linebuf;        /* line buffer for diagnostics */
247    JSTokenBuf          userbuf;        /* user input buffer if !file */
248    JSStringBuffer      tokenbuf;       /* current token string buffer */
249    const char          *filename;      /* input filename or null */
250    FILE                *file;          /* stdio stream if reading from file */
251    JSSourceHandler     listener;       /* callback for source; eg debugger */
252    void                *listenerData;  /* listener 'this' data */
253    void                *listenerTSData;/* listener data for this TokenStream */
254    jschar              *saveEOL;       /* save next end of line in userbuf, to
255                                           optimize for very long lines */
256};
257
258#define CURRENT_TOKEN(ts)       ((ts)->tokens[(ts)->cursor])
259#define ON_CURRENT_LINE(ts,pos) ((uint16)(ts)->lineno == (pos).end.lineno)
260
261/* JSTokenStream flags */
262#define TSF_ERROR       0x01            /* fatal error while compiling */
263#define TSF_EOF         0x02            /* hit end of file */
264#define TSF_NEWLINES    0x04            /* tokenize newlines */
265#define TSF_OPERAND     0x08            /* looking for operand, not operator */
266#define TSF_NLFLAG      0x20            /* last linebuf ended with \n */
267#define TSF_CRFLAG      0x40            /* linebuf would have ended with \r */
268#define TSF_DIRTYLINE   0x80            /* non-whitespace since start of line */
269#define TSF_OWNFILENAME 0x100           /* ts->filename is malloc'd */
270#define TSF_XMLTAGMODE  0x200           /* scanning within an XML tag in E4X */
271#define TSF_XMLTEXTMODE 0x400           /* scanning XMLText terminal from E4X */
272#define TSF_XMLONLYMODE 0x800           /* don't scan {expr} within text/tag */
273
274/* Flag indicating unexpected end of input, i.e. TOK_EOF not at top-level. */
275#define TSF_UNEXPECTED_EOF 0x1000
276
277/*
278 * To handle the hard case of contiguous HTML comments, we want to clear the
279 * TSF_DIRTYINPUT flag at the end of each such comment.  But we'd rather not
280 * scan for --> within every //-style comment unless we have to.  So we set
281 * TSF_IN_HTML_COMMENT when a <!-- is scanned as an HTML begin-comment, and
282 * clear it (and TSF_DIRTYINPUT) when we scan --> either on a clean line, or
283 * only if (ts->flags & TSF_IN_HTML_COMMENT), in a //-style comment.
284 *
285 * This still works as before given a malformed comment hiding hack such as:
286 *
287 *    <script>
288 *      <!-- comment hiding hack #1
289 *      code goes here
290 *      // --> oops, markup for script-unaware browsers goes here!
291 *    </script>
292 *
293 * It does not cope with malformed comment hiding hacks where --> is hidden
294 * by C-style comments, or on a dirty line.  Such cases are already broken.
295 */
296#define TSF_IN_HTML_COMMENT 0x2000
297
298/* Ignore keywords and return TOK_NAME instead to the parser. */
299#define TSF_KEYWORD_IS_NAME 0x4000
300
301/* Unicode separators that are treated as line terminators, in addition to \n, \r */
302#define LINE_SEPARATOR  0x2028
303#define PARA_SEPARATOR  0x2029
304
305/*
306 * Create a new token stream, either from an input buffer or from a file.
307 * Return null on file-open or memory-allocation failure.
308 *
309 * The function uses JSContext.tempPool to allocate internal buffers. The
310 * caller should release them using JS_ARENA_RELEASE after it has finished
311 * with the token stream and has called js_CloseTokenStream.
312 */
313extern JSBool
314js_InitTokenStream(JSContext *cx, JSTokenStream *ts,
315                   const jschar *base, size_t length,
316                   FILE *fp, const char *filename, uintN lineno);
317
318extern void
319js_CloseTokenStream(JSContext *cx, JSTokenStream *ts);
320
321extern JS_FRIEND_API(int)
322js_fgets(char *buf, int size, FILE *file);
323
324/*
325 * If the given char array forms JavaScript keyword, return corresponding
326 * token. Otherwise return TOK_EOF.
327 */
328extern JSTokenType
329js_CheckKeyword(const jschar *chars, size_t length);
330
331/*
332 * Friend-exported API entry point to call a mapping function on each reserved
333 * identifier in the scanner's keyword table.
334 */
335extern JS_FRIEND_API(void)
336js_MapKeywords(void (*mapfun)(const char *));
337
338/*
339 * Check that str forms a valid JS identifier name. The function does not
340 * check if str is a JS keyword.
341 */
342extern JSBool
343js_IsIdentifier(JSString *str);
344
345/*
346 * Report a compile-time error by its number. Return true for a warning, false
347 * for an error. When pn is not null, use it to report error's location.
348 * Otherwise use ts, which must not be null.
349 */
350JSBool
351js_ReportCompileErrorNumber(JSContext *cx, JSTokenStream *ts, JSParseNode *pn,
352                            uintN flags, uintN errorNumber, ...);
353
354/*
355 * Steal one JSREPORT_* bit (see jsapi.h) to tell that arguments to the error
356 * message have const jschar* type, not const char*.
357 */
358#define JSREPORT_UC 0x100
359
360/*
361 * Look ahead one token and return its type.
362 */
363extern JSTokenType
364js_PeekToken(JSContext *cx, JSTokenStream *ts);
365
366extern JSTokenType
367js_PeekTokenSameLine(JSContext *cx, JSTokenStream *ts);
368
369/*
370 * Get the next token from ts.
371 */
372extern JSTokenType
373js_GetToken(JSContext *cx, JSTokenStream *ts);
374
375/*
376 * Push back the last scanned token onto ts.
377 */
378extern void
379js_UngetToken(JSTokenStream *ts);
380
381/*
382 * Get the next token from ts if its type is tt.
383 */
384extern JSBool
385js_MatchToken(JSContext *cx, JSTokenStream *ts, JSTokenType tt);
386
387JS_END_EXTERN_C
388
389#endif /* jsscan_h___ */