solidity/libyul/AsmParser.cpp

494 lines
13 KiB
C++
Raw Normal View History

2016-02-22 01:13:41 +00:00
/*
This file is part of solidity.
2016-02-22 01:13:41 +00:00
solidity is free software: you can redistribute it and/or modify
2016-02-22 01:13:41 +00:00
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.
solidity is distributed in the hope that it will be useful,
2016-02-22 01:13:41 +00:00
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.
You should have received a copy of the GNU General Public License
along with solidity. If not, see <http://www.gnu.org/licenses/>.
2016-02-22 01:13:41 +00:00
*/
// SPDX-License-Identifier: GPL-3.0
2016-02-22 01:13:41 +00:00
/**
* @author Christian <c@ethdev.com>
* @date 2016
* Solidity inline assembly parser.
*/
#include <libyul/AsmParser.h>
#include <libyul/AST.h>
#include <libyul/Exceptions.h>
#include <liblangutil/Scanner.h>
#include <liblangutil/ErrorReporter.h>
#include <libsolutil/Common.h>
#include <libsolutil/Visitor.h>
#include <boost/algorithm/string.hpp>
#include <cctype>
2016-02-22 01:13:41 +00:00
#include <algorithm>
using namespace std;
2019-12-11 16:31:36 +00:00
using namespace solidity;
using namespace solidity::util;
using namespace solidity::langutil;
using namespace solidity::yul;
2016-02-22 01:13:41 +00:00
unique_ptr<Block> Parser::parse(std::shared_ptr<Scanner> const& _scanner, bool _reuseScanner)
2016-02-22 01:13:41 +00:00
{
m_recursionDepth = 0;
_scanner->setScannerMode(ScannerKind::Yul);
ScopeGuard resetScanner([&]{ _scanner->setScannerMode(ScannerKind::Solidity); });
2016-02-22 01:13:41 +00:00
try
{
m_scanner = _scanner;
auto block = make_unique<Block>(parseBlock());
if (!_reuseScanner)
expectToken(Token::EOS);
return block;
2016-02-22 01:13:41 +00:00
}
catch (FatalError const&)
{
yulAssert(!m_errorReporter.errors().empty(), "Fatal error detected, but no error is reported.");
2016-02-22 01:13:41 +00:00
}
2016-02-22 01:13:41 +00:00
return nullptr;
}
Block Parser::parseBlock()
2016-02-22 01:13:41 +00:00
{
RecursionGuard recursionGuard(*this);
Block block = createWithLocation<Block>();
2016-02-22 01:13:41 +00:00
expectToken(Token::LBrace);
while (currentToken() != Token::RBrace)
2016-02-22 01:13:41 +00:00
block.statements.emplace_back(parseStatement());
block.location.end = currentLocation().end;
advance();
2016-02-22 01:13:41 +00:00
return block;
}
Statement Parser::parseStatement()
2016-02-22 01:13:41 +00:00
{
RecursionGuard recursionGuard(*this);
switch (currentToken())
2016-02-22 01:13:41 +00:00
{
case Token::Let:
return parseVariableDeclaration();
2017-01-31 22:59:41 +00:00
case Token::Function:
return parseFunctionDefinition();
2016-02-22 01:13:41 +00:00
case Token::LBrace:
return parseBlock();
case Token::If:
{
If _if = createWithLocation<If>();
advance();
_if.condition = make_unique<Expression>(parseExpression());
_if.body = parseBlock();
return Statement{move(_if)};
}
case Token::Switch:
{
Switch _switch = createWithLocation<Switch>();
advance();
_switch.expression = make_unique<Expression>(parseExpression());
while (currentToken() == Token::Case)
_switch.cases.emplace_back(parseCase());
if (currentToken() == Token::Default)
2017-05-19 17:04:40 +00:00
_switch.cases.emplace_back(parseCase());
if (currentToken() == Token::Default)
fatalParserError(6931_error, "Only one default case allowed.");
else if (currentToken() == Token::Case)
fatalParserError(4904_error, "Case not allowed after default case.");
2018-10-09 03:29:37 +00:00
if (_switch.cases.empty())
fatalParserError(2418_error, "Switch statement without any cases.");
_switch.location.end = _switch.cases.back().body.location.end;
return Statement{move(_switch)};
}
case Token::For:
return parseForLoop();
case Token::Break:
{
Statement stmt{createWithLocation<Break>()};
checkBreakContinuePosition("break");
advance();
return stmt;
}
case Token::Continue:
{
Statement stmt{createWithLocation<Continue>()};
checkBreakContinuePosition("continue");
advance();
return stmt;
}
2020-07-27 18:11:38 +00:00
case Token::Leave:
{
Statement stmt{createWithLocation<Leave>()};
if (!m_insideFunction)
m_errorReporter.syntaxError(8149_error, currentLocation(), "Keyword \"leave\" can only be used inside a function.");
advance();
return stmt;
}
2016-02-22 01:13:41 +00:00
default:
break;
}
2016-02-22 01:13:41 +00:00
// Options left:
// Expression/FunctionCall
// Assignment
variant<Literal, Identifier> elementary(parseLiteralOrIdentifier());
2019-05-16 19:19:50 +00:00
switch (currentToken())
2016-02-22 01:13:41 +00:00
{
case Token::LParen:
2017-12-08 13:01:22 +00:00
{
Expression expr = parseCall(std::move(elementary));
2020-08-31 14:29:12 +00:00
return ExpressionStatement{locationOf(expr), move(expr)};
2017-12-08 13:01:22 +00:00
}
case Token::Comma:
case Token::AssemblyAssign:
{
Assignment assignment;
assignment.location = locationOf(elementary);
while (true)
{
if (!holds_alternative<Identifier>(elementary))
{
auto const token = currentToken() == Token::Comma ? "," : ":=";
fatalParserError(
2856_error,
std::string("Variable name must precede \"") +
token +
"\"" +
(currentToken() == Token::Comma ? " in multiple assignment." : " in assignment.")
);
}
auto const& identifier = std::get<Identifier>(elementary);
if (m_dialect.builtin(identifier.name))
fatalParserError(6272_error, "Cannot assign to builtin function \"" + identifier.name.str() + "\".");
assignment.variableNames.emplace_back(identifier);
if (currentToken() != Token::Comma)
break;
expectToken(Token::Comma);
elementary = parseLiteralOrIdentifier();
}
expectToken(Token::AssemblyAssign);
2019-11-27 16:24:21 +00:00
assignment.value = make_unique<Expression>(parseExpression());
assignment.location.end = locationOf(*assignment.value).end;
2020-08-31 14:29:12 +00:00
return Statement{move(assignment)};
}
2016-02-22 01:13:41 +00:00
default:
fatalParserError(6913_error, "Call or assignment expected.");
2016-02-22 01:13:41 +00:00
break;
}
2019-05-16 19:19:50 +00:00
2020-11-05 01:25:53 +00:00
yulAssert(false, "");
return {};
2016-02-22 01:13:41 +00:00
}
Case Parser::parseCase()
{
RecursionGuard recursionGuard(*this);
Case _case = createWithLocation<Case>();
if (currentToken() == Token::Default)
advance();
else if (currentToken() == Token::Case)
{
advance();
variant<Literal, Identifier> literal = parseLiteralOrIdentifier();
if (!holds_alternative<Literal>(literal))
fatalParserError(4805_error, "Literal expected.");
_case.value = make_unique<Literal>(std::get<Literal>(std::move(literal)));
}
2017-05-19 17:04:40 +00:00
else
yulAssert(false, "Case or default case expected.");
_case.body = parseBlock();
_case.location.end = _case.body.location.end;
return _case;
}
ForLoop Parser::parseForLoop()
{
RecursionGuard recursionGuard(*this);
ForLoopComponent outerForLoopComponent = m_currentForLoopComponent;
ForLoop forLoop = createWithLocation<ForLoop>();
expectToken(Token::For);
m_currentForLoopComponent = ForLoopComponent::ForLoopPre;
forLoop.pre = parseBlock();
m_currentForLoopComponent = ForLoopComponent::None;
forLoop.condition = make_unique<Expression>(parseExpression());
m_currentForLoopComponent = ForLoopComponent::ForLoopPost;
forLoop.post = parseBlock();
m_currentForLoopComponent = ForLoopComponent::ForLoopBody;
forLoop.body = parseBlock();
forLoop.location.end = forLoop.body.location.end;
m_currentForLoopComponent = outerForLoopComponent;
return forLoop;
}
Expression Parser::parseExpression()
2016-02-22 01:13:41 +00:00
{
RecursionGuard recursionGuard(*this);
2019-05-16 19:19:50 +00:00
variant<Literal, Identifier> operation = parseLiteralOrIdentifier();
return visit(GenericVisitor{
[&](Identifier& _identifier) -> Expression
{
if (currentToken() == Token::LParen)
return parseCall(std::move(operation));
if (m_dialect.builtin(_identifier.name))
fatalParserError(
7104_error,
_identifier.location,
"Builtin function \"" + _identifier.name.str() + "\" must be called."
);
return move(_identifier);
},
[&](Literal& _literal) -> Expression
{
return move(_literal);
}
}, operation);
2016-02-22 01:13:41 +00:00
}
variant<Literal, Identifier> Parser::parseLiteralOrIdentifier()
{
RecursionGuard recursionGuard(*this);
switch (currentToken())
2016-02-22 01:13:41 +00:00
{
case Token::Identifier:
{
Identifier identifier{currentLocation(), YulString{currentLiteral()}};
advance();
return identifier;
2016-02-22 01:13:41 +00:00
}
case Token::StringLiteral:
case Token::Number:
case Token::TrueLiteral:
case Token::FalseLiteral:
2016-02-22 01:13:41 +00:00
{
LiteralKind kind = LiteralKind::Number;
switch (currentToken())
{
case Token::StringLiteral:
kind = LiteralKind::String;
break;
case Token::Number:
if (!isValidNumberLiteral(currentLiteral()))
fatalParserError(4828_error, "Invalid number literal.");
kind = LiteralKind::Number;
break;
case Token::TrueLiteral:
case Token::FalseLiteral:
kind = LiteralKind::Boolean;
break;
default:
break;
}
2017-04-26 22:58:34 +00:00
Literal literal{
currentLocation(),
kind,
YulString{currentLiteral()},
kind == LiteralKind::Boolean ? m_dialect.boolType : m_dialect.defaultType
2016-02-22 01:13:41 +00:00
};
advance();
2019-12-19 16:58:20 +00:00
if (currentToken() == Token::Colon)
2017-04-26 22:58:34 +00:00
{
expectToken(Token::Colon);
literal.location.end = currentLocation().end;
literal.type = expectAsmIdentifier();
2017-04-26 22:58:34 +00:00
}
2019-12-19 16:58:20 +00:00
return literal;
2016-02-22 01:13:41 +00:00
}
case Token::HexStringLiteral:
fatalParserError(3772_error, "Hex literals are not valid in this context.");
break;
2016-02-22 01:13:41 +00:00
default:
fatalParserError(1856_error, "Literal or identifier expected.");
2016-02-22 01:13:41 +00:00
}
return {};
2016-02-22 01:13:41 +00:00
}
VariableDeclaration Parser::parseVariableDeclaration()
2016-02-22 01:13:41 +00:00
{
RecursionGuard recursionGuard(*this);
2016-04-18 11:47:40 +00:00
VariableDeclaration varDecl = createWithLocation<VariableDeclaration>();
2016-02-22 01:13:41 +00:00
expectToken(Token::Let);
while (true)
{
varDecl.variables.emplace_back(parseTypedName());
if (currentToken() == Token::Comma)
expectToken(Token::Comma);
else
break;
}
if (currentToken() == Token::AssemblyAssign)
{
expectToken(Token::AssemblyAssign);
varDecl.value = make_unique<Expression>(parseExpression());
varDecl.location.end = locationOf(*varDecl.value).end;
}
else
varDecl.location.end = varDecl.variables.back().location.end;
2016-04-18 11:47:40 +00:00
return varDecl;
2016-02-22 01:13:41 +00:00
}
FunctionDefinition Parser::parseFunctionDefinition()
2017-01-31 22:59:41 +00:00
{
RecursionGuard recursionGuard(*this);
if (m_currentForLoopComponent == ForLoopComponent::ForLoopPre)
m_errorReporter.syntaxError(
3441_error,
currentLocation(),
"Functions cannot be defined inside a for-loop init block."
);
ForLoopComponent outerForLoopComponent = m_currentForLoopComponent;
m_currentForLoopComponent = ForLoopComponent::None;
2017-01-31 22:59:41 +00:00
FunctionDefinition funDef = createWithLocation<FunctionDefinition>();
expectToken(Token::Function);
funDef.name = expectAsmIdentifier();
2017-01-31 22:59:41 +00:00
expectToken(Token::LParen);
while (currentToken() != Token::RParen)
2017-01-31 22:59:41 +00:00
{
funDef.parameters.emplace_back(parseTypedName());
if (currentToken() == Token::RParen)
2017-01-31 22:59:41 +00:00
break;
expectToken(Token::Comma);
}
expectToken(Token::RParen);
if (currentToken() == Token::RightArrow)
2017-01-31 22:59:41 +00:00
{
expectToken(Token::RightArrow);
2017-01-31 22:59:41 +00:00
while (true)
{
funDef.returnVariables.emplace_back(parseTypedName());
if (currentToken() == Token::LBrace)
2017-01-31 22:59:41 +00:00
break;
expectToken(Token::Comma);
}
}
2019-10-28 14:25:02 +00:00
bool preInsideFunction = m_insideFunction;
m_insideFunction = true;
2017-01-31 22:59:41 +00:00
funDef.body = parseBlock();
2019-10-28 14:25:02 +00:00
m_insideFunction = preInsideFunction;
2017-01-31 22:59:41 +00:00
funDef.location.end = funDef.body.location.end;
m_currentForLoopComponent = outerForLoopComponent;
2017-01-31 22:59:41 +00:00
return funDef;
}
FunctionCall Parser::parseCall(variant<Literal, Identifier>&& _initialOp)
2016-02-22 01:13:41 +00:00
{
RecursionGuard recursionGuard(*this);
2020-07-30 11:12:55 +00:00
if (!holds_alternative<Identifier>(_initialOp))
fatalParserError(9980_error, "Function name expected.");
2017-02-01 20:20:21 +00:00
2020-07-30 11:12:55 +00:00
FunctionCall ret;
ret.functionName = std::move(std::get<Identifier>(_initialOp));
ret.location = ret.functionName.location;
expectToken(Token::LParen);
if (currentToken() != Token::RParen)
{
ret.arguments.emplace_back(parseExpression());
while (currentToken() != Token::RParen)
{
expectToken(Token::Comma);
ret.arguments.emplace_back(parseExpression());
}
}
ret.location.end = currentLocation().end;
expectToken(Token::RParen);
return ret;
2016-02-22 01:13:41 +00:00
}
2017-01-31 22:59:41 +00:00
2017-04-26 22:58:34 +00:00
TypedName Parser::parseTypedName()
{
RecursionGuard recursionGuard(*this);
2017-04-26 22:58:34 +00:00
TypedName typedName = createWithLocation<TypedName>();
typedName.name = expectAsmIdentifier();
2019-12-19 16:58:20 +00:00
if (currentToken() == Token::Colon)
2017-04-26 22:58:34 +00:00
{
expectToken(Token::Colon);
typedName.location.end = currentLocation().end;
typedName.type = expectAsmIdentifier();
2017-04-26 22:58:34 +00:00
}
else
typedName.type = m_dialect.defaultType;
2017-04-26 22:58:34 +00:00
return typedName;
}
YulString Parser::expectAsmIdentifier()
2017-01-31 22:59:41 +00:00
{
2019-06-18 16:12:30 +00:00
YulString name{currentLiteral()};
if (currentToken() == Token::Identifier && m_dialect.builtin(name))
fatalParserError(5568_error, "Cannot use builtin function name \"" + name.str() + "\" as identifier name.");
// NOTE: We keep the expectation here to ensure the correct source location for the error above.
expectToken(Token::Identifier);
2017-01-31 22:59:41 +00:00
return name;
}
void Parser::checkBreakContinuePosition(string const& _which)
{
switch (m_currentForLoopComponent)
{
case ForLoopComponent::None:
m_errorReporter.syntaxError(2592_error, currentLocation(), "Keyword \"" + _which + "\" needs to be inside a for-loop body.");
break;
case ForLoopComponent::ForLoopPre:
m_errorReporter.syntaxError(9615_error, currentLocation(), "Keyword \"" + _which + "\" in for-loop init block is not allowed.");
break;
case ForLoopComponent::ForLoopPost:
m_errorReporter.syntaxError(2461_error, currentLocation(), "Keyword \"" + _which + "\" in for-loop post block is not allowed.");
break;
case ForLoopComponent::ForLoopBody:
break;
}
}
bool Parser::isValidNumberLiteral(string const& _literal)
{
try
{
// Try to convert _literal to u256.
2020-01-07 14:45:57 +00:00
[[maybe_unused]] auto tmp = u256(_literal);
}
catch (...)
{
return false;
}
if (boost::starts_with(_literal, "0x"))
return true;
else
return _literal.find_first_not_of("0123456789") == string::npos;
}