2017-02-09 13:04:23 +00:00
|
|
|
/*
|
|
|
|
This file is part of solidity.
|
|
|
|
|
|
|
|
solidity 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.
|
|
|
|
|
|
|
|
solidity 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.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
|
along with solidity. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
*/
|
2020-07-17 14:54:12 +00:00
|
|
|
// SPDX-License-Identifier: GPL-3.0
|
2017-02-09 13:04:23 +00:00
|
|
|
/**
|
|
|
|
* @author Christian <c@ethdev.com>
|
|
|
|
* @date 2017
|
|
|
|
* Converts a parsed assembly into its textual form.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
2020-10-29 14:00:27 +00:00
|
|
|
#include <libyul/ASTForward.h>
|
2018-10-29 14:12:02 +00:00
|
|
|
#include <libyul/YulString.h>
|
|
|
|
|
2021-07-13 14:06:07 +00:00
|
|
|
#include <libsolutil/CommonData.h>
|
|
|
|
|
2021-08-31 13:10:40 +00:00
|
|
|
#include <liblangutil/CharStreamProvider.h>
|
2021-07-13 14:06:07 +00:00
|
|
|
#include <liblangutil/SourceLocation.h>
|
|
|
|
|
|
|
|
#include <map>
|
|
|
|
|
2019-12-11 16:31:36 +00:00
|
|
|
namespace solidity::yul
|
2017-02-09 13:04:23 +00:00
|
|
|
{
|
2019-12-19 16:58:20 +00:00
|
|
|
struct Dialect;
|
2017-02-09 13:04:23 +00:00
|
|
|
|
2020-01-16 11:03:19 +00:00
|
|
|
/**
|
|
|
|
* Converts a parsed Yul AST into readable string representation.
|
|
|
|
* Ignores source locations.
|
|
|
|
* If a dialect is provided, the dialect's default type is omitted.
|
|
|
|
*/
|
2019-11-19 15:42:49 +00:00
|
|
|
class AsmPrinter
|
2017-02-09 13:04:23 +00:00
|
|
|
{
|
|
|
|
public:
|
2021-07-13 14:06:07 +00:00
|
|
|
explicit AsmPrinter(
|
|
|
|
Dialect const* _dialect = nullptr,
|
2021-08-31 13:10:40 +00:00
|
|
|
std::optional<std::map<unsigned, std::shared_ptr<std::string const>>> _sourceIndexToName = {},
|
|
|
|
langutil::CharStreamProvider const* _soliditySourceProvider = nullptr
|
2021-07-13 14:06:07 +00:00
|
|
|
):
|
2021-08-31 13:10:40 +00:00
|
|
|
m_dialect(_dialect),
|
|
|
|
m_soliditySourceProvider(_soliditySourceProvider)
|
2021-07-13 14:06:07 +00:00
|
|
|
{
|
|
|
|
if (_sourceIndexToName)
|
|
|
|
for (auto&& [index, name]: *_sourceIndexToName)
|
|
|
|
m_nameToSourceIndex[*name] = index;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
explicit AsmPrinter(
|
|
|
|
Dialect const& _dialect,
|
2021-08-31 13:10:40 +00:00
|
|
|
std::optional<std::map<unsigned, std::shared_ptr<std::string const>>> _sourceIndexToName = {},
|
|
|
|
langutil::CharStreamProvider const* _soliditySourceProvider = nullptr
|
|
|
|
): AsmPrinter(&_dialect, _sourceIndexToName, _soliditySourceProvider) {}
|
2021-07-13 14:06:07 +00:00
|
|
|
|
|
|
|
std::string operator()(Literal const& _literal);
|
|
|
|
std::string operator()(Identifier const& _identifier);
|
|
|
|
std::string operator()(ExpressionStatement const& _expr);
|
|
|
|
std::string operator()(Assignment const& _assignment);
|
|
|
|
std::string operator()(VariableDeclaration const& _variableDeclaration);
|
|
|
|
std::string operator()(FunctionDefinition const& _functionDefinition);
|
|
|
|
std::string operator()(FunctionCall const& _functionCall);
|
|
|
|
std::string operator()(If const& _if);
|
|
|
|
std::string operator()(Switch const& _switch);
|
|
|
|
std::string operator()(ForLoop const& _forLoop);
|
|
|
|
std::string operator()(Break const& _break);
|
|
|
|
std::string operator()(Continue const& _continue);
|
|
|
|
std::string operator()(Leave const& _continue);
|
|
|
|
std::string operator()(Block const& _block);
|
2017-04-26 22:58:08 +00:00
|
|
|
|
2021-09-06 16:52:48 +00:00
|
|
|
static std::string formatSourceLocation(
|
2021-08-31 13:08:16 +00:00
|
|
|
langutil::SourceLocation const& _location,
|
|
|
|
std::map<std::string, unsigned> const& _nameToSourceIndex,
|
2021-08-31 13:10:40 +00:00
|
|
|
langutil::CharStreamProvider const* m_soliditySourceProvider = nullptr
|
2021-08-31 13:08:16 +00:00
|
|
|
);
|
|
|
|
|
2017-04-26 22:58:08 +00:00
|
|
|
private:
|
2021-07-13 14:06:07 +00:00
|
|
|
std::string formatTypedName(TypedName _variable);
|
2020-01-29 17:14:20 +00:00
|
|
|
std::string appendTypeName(YulString _type, bool _isBoolLiteral = false) const;
|
2021-09-06 16:41:02 +00:00
|
|
|
std::string formatDebugData(std::shared_ptr<DebugData const> const& _debugData, bool _statement);
|
2021-07-13 14:06:07 +00:00
|
|
|
template <class T>
|
2021-09-06 16:41:02 +00:00
|
|
|
std::string formatDebugData(T const& _node)
|
2021-07-13 14:06:07 +00:00
|
|
|
{
|
|
|
|
bool isExpression = std::is_constructible<Expression, T>::value;
|
2021-09-06 16:41:02 +00:00
|
|
|
return formatDebugData(_node.debugData, !isExpression);
|
2021-07-13 14:06:07 +00:00
|
|
|
}
|
2020-01-16 11:03:19 +00:00
|
|
|
|
2021-07-13 14:06:07 +00:00
|
|
|
Dialect const* const m_dialect = nullptr;
|
2021-08-31 13:08:16 +00:00
|
|
|
std::map<std::string, unsigned> m_nameToSourceIndex;
|
2021-07-13 14:06:07 +00:00
|
|
|
langutil::SourceLocation m_lastLocation = {};
|
2021-08-31 13:10:40 +00:00
|
|
|
langutil::CharStreamProvider const* m_soliditySourceProvider = nullptr;
|
2017-02-09 13:04:23 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
}
|