1/* 2 Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies) 3 4 This library is free software; you can redistribute it and/or 5 modify it under the terms of the GNU Library General Public 6 License as published by the Free Software Foundation; either 7 version 2 of the License, or (at your option) any later version. 8 9 This library is distributed in the hope that it will be useful, 10 but WITHOUT ANY WARRANTY; without even the implied warranty of 11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 12 Library General Public License for more details. 13 14 You should have received a copy of the GNU Library General Public License 15 along with this library; see the file COPYING.LIB. If not, write to 16 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, 17 Boston, MA 02110-1301, USA. 18*/ 19 20#include "config.h" 21 22#include "qscriptsyntaxcheckresult.h" 23#include "qscriptsyntaxcheckresult_p.h" 24 25/*! 26 \class QScriptSyntaxCheckResult 27 28 \brief The QScriptSyntaxCheckResult class provides the result of a script syntax check. 29 30 \ingroup script 31 \mainclass 32 33 QScriptSyntaxCheckResult is returned by QScriptEngine::checkSyntax() to 34 provide information about the syntactical (in)correctness of a script. 35*/ 36 37/*! 38 \enum QScriptSyntaxCheckResult::State 39 40 This enum specifies the state of a syntax check. 41 42 \value Error The program contains a syntax error. 43 \value Intermediate The program is incomplete. 44 \value Valid The program is a syntactically correct Qt Script program. 45*/ 46 47/*! 48 Constructs a new QScriptSyntaxCheckResult from the \a other result. 49*/ 50QScriptSyntaxCheckResult::QScriptSyntaxCheckResult(const QScriptSyntaxCheckResult& other) 51 : d_ptr(other.d_ptr) 52{} 53 54/*! 55 Constructs a new QScriptSyntaxCheckResult from an internal representation. 56 \internal 57*/ 58QScriptSyntaxCheckResult::QScriptSyntaxCheckResult(QScriptSyntaxCheckResultPrivate* d) 59 : d_ptr(d) 60{} 61 62/*! 63 Destroys this QScriptSyntaxCheckResult. 64*/ 65QScriptSyntaxCheckResult::~QScriptSyntaxCheckResult() 66{} 67 68/*! 69 Assigns the \a other result to this QScriptSyntaxCheckResult, and returns a 70 reference to this QScriptSyntaxCheckResult. 71*/ 72QScriptSyntaxCheckResult& QScriptSyntaxCheckResult::operator=(const QScriptSyntaxCheckResult& other) 73{ 74 d_ptr = other.d_ptr; 75 return *this; 76} 77 78/*! 79 Returns the state of this QScriptSyntaxCheckResult. 80*/ 81QScriptSyntaxCheckResult::State QScriptSyntaxCheckResult::state() const 82{ 83 return d_ptr->state(); 84} 85 86/*! 87 Returns the error line number of this QScriptSyntaxCheckResult, or -1 if 88 there is no error. 89 90 \sa state(), errorMessage() 91*/ 92int QScriptSyntaxCheckResult::errorLineNumber() const 93{ 94 return d_ptr->errorLineNumber(); 95} 96 97/*! 98 Returns the error column number of this QScriptSyntaxCheckResult, or -1 if 99 there is no error. 100 101 \sa state(), errorLineNumber() 102*/ 103int QScriptSyntaxCheckResult::errorColumnNumber() const 104{ 105 return d_ptr->errorColumnNumber(); 106} 107 108/*! 109 Returns the error message of this QScriptSyntaxCheckResult, or an empty 110 string if there is no error. 111 112 \sa state(), errorLineNumber() 113*/ 114QString QScriptSyntaxCheckResult::errorMessage() const 115{ 116 return d_ptr->errorMessage(); 117} 118 119QScriptSyntaxCheckResultPrivate::~QScriptSyntaxCheckResultPrivate() 120{ 121 if (m_exception) 122 JSValueUnprotect(*m_engine, m_exception); 123} 124 125QString QScriptSyntaxCheckResultPrivate::errorMessage() const 126{ 127 if (!m_exception) 128 return QString(); 129 130 JSStringRef tmp = JSValueToStringCopy(*m_engine, m_exception, /* exception */ 0); 131 QString message = QScriptConverter::toString(tmp); 132 JSStringRelease(tmp); 133 return message; 134} 135 136int QScriptSyntaxCheckResultPrivate::errorLineNumber() const 137{ 138 if (!m_exception) 139 return -1; 140 // m_exception is an instance of the Exception so it has "line" attribute. 141 JSStringRef lineAttrName = QScriptConverter::toString("line"); 142 JSValueRef line = JSObjectGetProperty(*m_engine, 143 m_exception, 144 lineAttrName, 145 /* exceptions */0); 146 JSStringRelease(lineAttrName); 147 return JSValueToNumber(*m_engine, line, /* exceptions */0); 148} 149