2014-10-07 16:25:04 +00:00
|
|
|
/*
|
2014-10-16 12:08:54 +00:00
|
|
|
This file is part of cpp-ethereum.
|
2014-10-07 16:25:04 +00:00
|
|
|
|
2014-10-16 12:08:54 +00:00
|
|
|
cpp-ethereum is free software: you can redistribute it and/or modify
|
|
|
|
it under the terms of the GNU General Public License as published by
|
|
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
|
|
(at your option) any later version.
|
2014-10-07 16:25:04 +00:00
|
|
|
|
2014-10-16 12:08:54 +00:00
|
|
|
cpp-ethereum is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
GNU General Public License for more details.
|
2014-10-07 16:25:04 +00:00
|
|
|
|
2014-10-16 12:08:54 +00:00
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
|
along with cpp-ethereum. If not, see <http://www.gnu.org/licenses/>.
|
2014-10-07 16:25:04 +00:00
|
|
|
*/
|
|
|
|
/**
|
|
|
|
* @author Christian <c@ethdev.com>
|
|
|
|
* @date 2014
|
|
|
|
* Solidity parser.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include "libsolidity/AST.h"
|
|
|
|
|
2014-10-16 12:08:54 +00:00
|
|
|
namespace dev
|
|
|
|
{
|
|
|
|
namespace solidity
|
|
|
|
{
|
2014-10-07 16:25:04 +00:00
|
|
|
|
|
|
|
class Scanner;
|
|
|
|
|
|
|
|
class Parser
|
|
|
|
{
|
|
|
|
public:
|
2015-03-10 14:11:13 +00:00
|
|
|
Parser() {}
|
|
|
|
|
2014-12-03 06:46:55 +00:00
|
|
|
ASTPointer<SourceUnit> parse(std::shared_ptr<Scanner> const& _scanner);
|
2014-12-03 17:52:28 +00:00
|
|
|
std::shared_ptr<std::string const> const& getSourceName() const;
|
2014-10-07 16:25:04 +00:00
|
|
|
|
|
|
|
private:
|
2014-10-09 10:28:37 +00:00
|
|
|
class ASTNodeFactory;
|
2014-10-07 16:25:04 +00:00
|
|
|
|
2014-10-09 10:28:37 +00:00
|
|
|
/// Start position of the current token
|
|
|
|
int getPosition() const;
|
|
|
|
/// End position of the current token
|
|
|
|
int getEndPosition() const;
|
2014-10-07 16:25:04 +00:00
|
|
|
|
2015-01-29 13:35:28 +00:00
|
|
|
struct VarDeclParserOptions {
|
|
|
|
VarDeclParserOptions() {}
|
|
|
|
bool allowVar = false;
|
|
|
|
bool isStateVariable = false;
|
|
|
|
bool allowIndexed = false;
|
2015-02-09 01:06:30 +00:00
|
|
|
bool allowEmptyName = false;
|
2015-02-17 15:21:38 +00:00
|
|
|
bool allowInitialValue = false;
|
2015-01-29 13:35:28 +00:00
|
|
|
};
|
|
|
|
|
2014-10-22 18:35:35 +00:00
|
|
|
///@{
|
|
|
|
///@name Parsing functions for the AST nodes
|
2014-12-03 06:46:55 +00:00
|
|
|
ASTPointer<ImportDirective> parseImportDirective();
|
2014-10-20 12:00:37 +00:00
|
|
|
ASTPointer<ContractDefinition> parseContractDefinition();
|
2015-01-19 20:05:47 +00:00
|
|
|
ASTPointer<InheritanceSpecifier> parseInheritanceSpecifier();
|
2015-02-02 16:24:09 +00:00
|
|
|
Declaration::Visibility parseVisibilitySpecifier(Token::Value _token);
|
|
|
|
ASTPointer<FunctionDefinition> parseFunctionDefinition(ASTString const* _contractName);
|
2014-10-20 12:00:37 +00:00
|
|
|
ASTPointer<StructDefinition> parseStructDefinition();
|
2015-02-09 17:08:56 +00:00
|
|
|
ASTPointer<EnumDefinition> parseEnumDefinition();
|
2015-02-13 21:52:04 +00:00
|
|
|
ASTPointer<EnumValue> parseEnumValue();
|
2015-03-12 13:15:04 +00:00
|
|
|
ASTPointer<VariableDeclaration> parseVariableDeclaration(VarDeclParserOptions const& _options = VarDeclParserOptions(),
|
2015-02-20 14:52:30 +00:00
|
|
|
ASTPointer<TypeName> const& _lookAheadArrayType = ASTPointer<TypeName>());
|
2015-01-21 10:16:18 +00:00
|
|
|
ASTPointer<ModifierDefinition> parseModifierDefinition();
|
2015-01-29 13:35:28 +00:00
|
|
|
ASTPointer<EventDefinition> parseEventDefinition();
|
2015-01-22 00:02:38 +00:00
|
|
|
ASTPointer<ModifierInvocation> parseModifierInvocation();
|
2015-01-28 10:28:22 +00:00
|
|
|
ASTPointer<Identifier> parseIdentifier();
|
2014-10-20 12:00:37 +00:00
|
|
|
ASTPointer<TypeName> parseTypeName(bool _allowVar);
|
|
|
|
ASTPointer<Mapping> parseMapping();
|
2015-01-29 13:35:28 +00:00
|
|
|
ASTPointer<ParameterList> parseParameterList(bool _allowEmpty = true, bool _allowIndexed = false);
|
2014-10-20 12:00:37 +00:00
|
|
|
ASTPointer<Block> parseBlock();
|
|
|
|
ASTPointer<Statement> parseStatement();
|
|
|
|
ASTPointer<IfStatement> parseIfStatement();
|
|
|
|
ASTPointer<WhileStatement> parseWhileStatement();
|
2014-12-15 16:45:18 +00:00
|
|
|
ASTPointer<ForStatement> parseForStatement();
|
2015-02-20 14:52:30 +00:00
|
|
|
/// A "simple statement" can be a variable declaration statement or an expression statement.
|
|
|
|
ASTPointer<Statement> parseSimpleStatement();
|
|
|
|
ASTPointer<VariableDeclarationStatement> parseVariableDeclarationStatement(
|
|
|
|
ASTPointer<TypeName> const& _lookAheadArrayType = ASTPointer<TypeName>());
|
|
|
|
ASTPointer<ExpressionStatement> parseExpressionStatement(
|
2015-02-23 13:38:44 +00:00
|
|
|
ASTPointer<Expression> const& _lookAheadIndexAccessStructure = ASTPointer<Expression>());
|
2015-02-20 14:52:30 +00:00
|
|
|
ASTPointer<Expression> parseExpression(
|
2015-02-23 13:38:44 +00:00
|
|
|
ASTPointer<Expression> const& _lookAheadIndexAccessStructure = ASTPointer<Expression>());
|
2015-02-20 14:52:30 +00:00
|
|
|
ASTPointer<Expression> parseBinaryExpression(int _minPrecedence = 4,
|
2015-02-23 13:38:44 +00:00
|
|
|
ASTPointer<Expression> const& _lookAheadIndexAccessStructure = ASTPointer<Expression>());
|
2015-02-20 14:52:30 +00:00
|
|
|
ASTPointer<Expression> parseUnaryExpression(
|
2015-02-23 13:38:44 +00:00
|
|
|
ASTPointer<Expression> const& _lookAheadIndexAccessStructure = ASTPointer<Expression>());
|
2015-02-20 14:52:30 +00:00
|
|
|
ASTPointer<Expression> parseLeftHandSideExpression(
|
2015-02-23 13:38:44 +00:00
|
|
|
ASTPointer<Expression> const& _lookAheadIndexAccessStructure = ASTPointer<Expression>());
|
2014-10-20 12:00:37 +00:00
|
|
|
ASTPointer<Expression> parsePrimaryExpression();
|
2015-01-29 17:26:00 +00:00
|
|
|
std::vector<ASTPointer<Expression>> parseFunctionCallListArguments();
|
2015-02-03 20:25:08 +00:00
|
|
|
std::pair<std::vector<ASTPointer<Expression>>, std::vector<ASTPointer<ASTString>>> parseFunctionCallArguments();
|
2014-10-22 18:35:35 +00:00
|
|
|
///@}
|
|
|
|
|
|
|
|
///@{
|
|
|
|
///@name Helper functions
|
2014-10-07 16:25:04 +00:00
|
|
|
|
2015-02-23 13:38:44 +00:00
|
|
|
/// Used as return value of @see peekStatementType.
|
|
|
|
enum class LookAheadInfo
|
|
|
|
{
|
|
|
|
IndexAccessStructure, VariableDeclarationStatement, ExpressionStatement
|
|
|
|
};
|
|
|
|
|
2015-02-20 14:52:30 +00:00
|
|
|
/// Performs limited look-ahead to distinguish between variable declaration and expression statement.
|
2015-02-23 13:55:06 +00:00
|
|
|
/// For source code of the form "a[][8]" ("IndexAccessStructure"), this is not possible to
|
2015-02-23 13:38:44 +00:00
|
|
|
/// decide with constant look-ahead.
|
|
|
|
LookAheadInfo peekStatementType() const;
|
2015-02-20 14:52:30 +00:00
|
|
|
/// Returns a typename parsed in look-ahead fashion from something like "a[8][2**70]".
|
2015-02-23 13:38:44 +00:00
|
|
|
ASTPointer<TypeName> typeNameIndexAccessStructure(
|
2015-02-20 14:52:30 +00:00
|
|
|
ASTPointer<PrimaryExpression> const& _primary,
|
2015-02-24 16:31:06 +00:00
|
|
|
std::vector<std::pair<ASTPointer<Expression>, SourceLocation>> const& _indices);
|
2015-02-20 14:52:30 +00:00
|
|
|
/// Returns an expression parsed in look-ahead fashion from something like "a[8][2**70]".
|
2015-02-23 13:38:44 +00:00
|
|
|
ASTPointer<Expression> expressionFromIndexAccessStructure(
|
2015-02-20 14:52:30 +00:00
|
|
|
ASTPointer<PrimaryExpression> const& _primary,
|
2015-02-24 16:31:06 +00:00
|
|
|
std::vector<std::pair<ASTPointer<Expression>, SourceLocation>> const& _indices);
|
2014-10-09 10:28:37 +00:00
|
|
|
/// If current token value is not _value, throw exception otherwise advance token.
|
|
|
|
void expectToken(Token::Value _value);
|
2014-10-09 13:57:49 +00:00
|
|
|
Token::Value expectAssignmentOperator();
|
2014-10-20 12:00:37 +00:00
|
|
|
ASTPointer<ASTString> expectIdentifierToken();
|
|
|
|
ASTPointer<ASTString> getLiteralAndAdvance();
|
2014-10-22 18:35:35 +00:00
|
|
|
///@}
|
2014-10-07 16:25:04 +00:00
|
|
|
|
2015-01-30 20:43:19 +00:00
|
|
|
/// Creates an empty ParameterList at the current location (used if parameters can be omitted).
|
|
|
|
ASTPointer<ParameterList> createEmptyParameterList();
|
|
|
|
|
2014-10-23 17:22:30 +00:00
|
|
|
/// Creates a @ref ParserError exception and annotates it with the current position and the
|
|
|
|
/// given @a _description.
|
|
|
|
ParserError createParserError(std::string const& _description) const;
|
|
|
|
|
2014-10-09 10:28:37 +00:00
|
|
|
std::shared_ptr<Scanner> m_scanner;
|
2015-01-21 10:16:18 +00:00
|
|
|
/// Flag that signifies whether '_' is parsed as a PlaceholderStatement or a regular identifier.
|
|
|
|
bool m_insideModifier = false;
|
2014-10-07 16:25:04 +00:00
|
|
|
};
|
|
|
|
|
2014-10-16 12:08:54 +00:00
|
|
|
}
|
|
|
|
}
|