mirror of
				https://github.com/ethereum/solidity
				synced 2023-10-03 13:03:40 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			112 lines
		
	
	
		
			4.0 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			112 lines
		
	
	
		
			4.0 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
| /*
 | |
| 	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/>.
 | |
| */
 | |
| // SPDX-License-Identifier: GPL-3.0
 | |
| /**
 | |
|  * @author Christian <c@ethdev.com>
 | |
|  * @date 2017
 | |
|  * Converts a parsed assembly into its textual form.
 | |
|  */
 | |
| 
 | |
| #pragma once
 | |
| 
 | |
| #include <libyul/ASTForward.h>
 | |
| #include <libyul/YulString.h>
 | |
| 
 | |
| #include <libsolutil/CommonData.h>
 | |
| 
 | |
| #include <liblangutil/CharStreamProvider.h>
 | |
| #include <liblangutil/DebugInfoSelection.h>
 | |
| #include <liblangutil/SourceLocation.h>
 | |
| 
 | |
| #include <map>
 | |
| 
 | |
| namespace solidity::yul
 | |
| {
 | |
| struct Dialect;
 | |
| 
 | |
| /**
 | |
|  * Converts a parsed Yul AST into readable string representation.
 | |
|  * Ignores source locations.
 | |
|  * If a dialect is provided, the dialect's default type is omitted.
 | |
|  */
 | |
| class AsmPrinter
 | |
| {
 | |
| public:
 | |
| 	explicit AsmPrinter(
 | |
| 		Dialect const* _dialect = nullptr,
 | |
| 		std::optional<std::map<unsigned, std::shared_ptr<std::string const>>> _sourceIndexToName = {},
 | |
| 		langutil::DebugInfoSelection const& _debugInfoSelection = langutil::DebugInfoSelection::Default(),
 | |
| 		langutil::CharStreamProvider const* _soliditySourceProvider = nullptr
 | |
| 	):
 | |
| 		m_dialect(_dialect),
 | |
| 		m_debugInfoSelection(_debugInfoSelection),
 | |
| 		m_soliditySourceProvider(_soliditySourceProvider)
 | |
| 	{
 | |
| 		if (_sourceIndexToName)
 | |
| 			for (auto&& [index, name]: *_sourceIndexToName)
 | |
| 				m_nameToSourceIndex[*name] = index;
 | |
| 	}
 | |
| 
 | |
| 	explicit AsmPrinter(
 | |
| 		Dialect const& _dialect,
 | |
| 		std::optional<std::map<unsigned, std::shared_ptr<std::string const>>> _sourceIndexToName = {},
 | |
| 		langutil::DebugInfoSelection const& _debugInfoSelection = langutil::DebugInfoSelection::Default(),
 | |
| 		langutil::CharStreamProvider const* _soliditySourceProvider = nullptr
 | |
| 	): AsmPrinter(&_dialect, _sourceIndexToName, _debugInfoSelection, _soliditySourceProvider) {}
 | |
| 
 | |
| 	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);
 | |
| 
 | |
| 	static std::string formatSourceLocation(
 | |
| 		langutil::SourceLocation const& _location,
 | |
| 		std::map<std::string, unsigned> const& _nameToSourceIndex,
 | |
| 		langutil::DebugInfoSelection const& _debugInfoSelection = langutil::DebugInfoSelection::Default(),
 | |
| 		langutil::CharStreamProvider const* m_soliditySourceProvider = nullptr
 | |
| 	);
 | |
| 
 | |
| private:
 | |
| 	std::string formatTypedName(TypedName _variable);
 | |
| 	std::string appendTypeName(YulString _type, bool _isBoolLiteral = false) const;
 | |
| 	std::string formatDebugData(std::shared_ptr<DebugData const> const& _debugData, bool _statement);
 | |
| 	template <class T>
 | |
| 	std::string formatDebugData(T const& _node)
 | |
| 	{
 | |
| 		bool isExpression = std::is_constructible<Expression, T>::value;
 | |
| 		return formatDebugData(_node.debugData, !isExpression);
 | |
| 	}
 | |
| 
 | |
| 	Dialect const* const m_dialect = nullptr;
 | |
| 	std::map<std::string, unsigned> m_nameToSourceIndex;
 | |
| 	langutil::SourceLocation m_lastLocation = {};
 | |
| 	langutil::DebugInfoSelection m_debugInfoSelection = {};
 | |
| 	langutil::CharStreamProvider const* m_soliditySourceProvider = nullptr;
 | |
| };
 | |
| 
 | |
| }
 |