kjs/Parser.h

   1 // -*- c-basic-offset: 4 -*-
   2 /*
   3  *  This file is part of the KDE libraries
   4  *  Copyright (C) 1999-2001 Harri Porten (porten@kde.org)
   5  *  Copyright (C) 2001 Peter Kelly (pmk@post.com)
   6  *  Copyright (C) 2003, 2006 Apple Computer, Inc.
   7  *
   8  *  This library is free software; you can redistribute it and/or
   9  *  modify it under the terms of the GNU Library General Public
  10  *  License as published by the Free Software Foundation; either
  11  *  version 2 of the License, or (at your option) any later version.
  12  *
  13  *  This library is distributed in the hope that it will be useful,
  14  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  *  Library General Public License for more details.
  17  *
  18  *  You should have received a copy of the GNU Library General Public License
  19  *  along with this library; see the file COPYING.LIB.  If not, write to
  20  *  the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  21  *  Boston, MA 02110-1301, USA.
  22  *
  23  */
  24
  25 #ifndef Parser_h
  26 #define Parser_h
  27
  28 #include <wtf/Forward.h>
  29
  30 namespace KJS {
  31
  32     class Node;
  33     class ProgramNode;
  34     class UString;
  35     struct UChar;
  36
  37     /**
  38      * @internal
  39      *
  40      * Parses ECMAScript source code and converts into ProgramNode objects, which
  41      * represent the root of a parse tree. The tree is then semantically
  42      * checked with a semantic analyzer. This class provides a convenient
  43      * workaround for the problem of the bison parser working in a static context.
  44      */
  45     class Parser {
  46     public:
  47         static PassRefPtr<ProgramNode> parse(const UString& sourceURL, int startingLineNumber,
  48             const UChar* code, unsigned length,
  49             int* sourceId = 0, int* errLine = 0, UString* errMsg = 0);
  50
  51         static UString prettyPrint(const UString&, int* errLine = 0, UString* errMsg = 0);
  52
  53         static void accept(PassRefPtr<ProgramNode>);
  54
  55         static void saveNewNode(Node*);
  56         static void noteNodeCycle(Node*);
  57         static void removeNodeCycle(Node*);
  58
  59         static int sid;
  60     };
  61
  62 } // namespace
  63
  64 #endif