2018-12-03 14:49: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
|
2018-12-03 14:49:23 +00:00
|
|
|
/**
|
|
|
|
* Yul dialect.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include <libyul/YulString.h>
|
2019-08-13 12:40:26 +00:00
|
|
|
#include <libyul/SideEffects.h>
|
2020-03-05 09:47:01 +00:00
|
|
|
#include <libyul/ControlFlowSideEffects.h>
|
2018-12-03 14:49:23 +00:00
|
|
|
|
2018-12-06 23:56:16 +00:00
|
|
|
#include <boost/noncopyable.hpp>
|
|
|
|
|
|
|
|
#include <vector>
|
2019-05-29 21:14:06 +00:00
|
|
|
#include <set>
|
2020-04-06 12:47:44 +00:00
|
|
|
#include <optional>
|
2018-12-03 14:49:23 +00:00
|
|
|
|
2019-12-11 16:31:36 +00:00
|
|
|
namespace solidity::yul
|
2018-12-03 14:49:23 +00:00
|
|
|
{
|
|
|
|
|
|
|
|
class YulString;
|
|
|
|
using Type = YulString;
|
2020-01-16 17:56:05 +00:00
|
|
|
enum class LiteralKind;
|
2020-02-18 15:11:21 +00:00
|
|
|
struct Literal;
|
2018-12-03 14:49:23 +00:00
|
|
|
|
|
|
|
struct BuiltinFunction
|
|
|
|
{
|
|
|
|
YulString name;
|
|
|
|
std::vector<Type> parameters;
|
|
|
|
std::vector<Type> returns;
|
2019-08-13 12:40:26 +00:00
|
|
|
SideEffects sideEffects;
|
2020-03-05 09:47:01 +00:00
|
|
|
ControlFlowSideEffects controlFlowSideEffects;
|
2019-05-27 11:11:00 +00:00
|
|
|
/// If true, this is the msize instruction.
|
|
|
|
bool isMSize = false;
|
2020-08-04 15:30:16 +00:00
|
|
|
/// Must be empty or the same length as the arguments.
|
|
|
|
/// If set at index i, the i'th argument has to be a literal which means it can't be moved to variables.
|
|
|
|
std::vector<std::optional<LiteralKind>> literalArguments{};
|
|
|
|
std::optional<LiteralKind> literalArgument(size_t i) const
|
|
|
|
{
|
|
|
|
return literalArguments.empty() ? std::nullopt : literalArguments.at(i);
|
|
|
|
}
|
2018-12-03 14:49:23 +00:00
|
|
|
};
|
|
|
|
|
2018-12-06 23:56:16 +00:00
|
|
|
struct Dialect: boost::noncopyable
|
2018-12-03 14:49:23 +00:00
|
|
|
{
|
2020-01-29 17:14:20 +00:00
|
|
|
/// Default type, can be omitted.
|
2019-12-19 16:58:20 +00:00
|
|
|
YulString defaultType;
|
|
|
|
/// Type used for the literals "true" and "false".
|
|
|
|
YulString boolType;
|
2020-01-16 17:56:05 +00:00
|
|
|
std::set<YulString> types = {{}};
|
2019-12-19 16:58:20 +00:00
|
|
|
|
2018-12-03 14:49:23 +00:00
|
|
|
/// @returns the builtin function of the given name or a nullptr if it is not a builtin function.
|
2018-12-06 23:56:16 +00:00
|
|
|
virtual BuiltinFunction const* builtin(YulString /*_name*/) const { return nullptr; }
|
2018-12-03 14:49:23 +00:00
|
|
|
|
2020-02-18 23:18:13 +00:00
|
|
|
virtual BuiltinFunction const* discardFunction(YulString /* _type */) const { return nullptr; }
|
|
|
|
virtual BuiltinFunction const* equalityFunction(YulString /* _type */) const { return nullptr; }
|
2019-09-11 14:30:47 +00:00
|
|
|
virtual BuiltinFunction const* booleanNegationFunction() const { return nullptr; }
|
2019-05-28 10:57:15 +00:00
|
|
|
|
2020-01-16 17:56:05 +00:00
|
|
|
/// Check whether the given type is legal for the given literal value.
|
|
|
|
/// Should only be called if the type exists in the dialect at all.
|
|
|
|
virtual bool validTypeForLiteral(LiteralKind _kind, YulString _value, YulString _type) const;
|
|
|
|
|
2020-02-18 15:11:21 +00:00
|
|
|
virtual Literal zeroLiteralForType(YulString _type) const;
|
|
|
|
|
2019-05-29 21:14:06 +00:00
|
|
|
virtual std::set<YulString> fixedFunctionNames() const { return {}; }
|
|
|
|
|
2019-12-19 16:58:20 +00:00
|
|
|
Dialect() = default;
|
2018-12-12 13:51:22 +00:00
|
|
|
virtual ~Dialect() = default;
|
2018-12-03 14:49:23 +00:00
|
|
|
|
2020-01-29 17:14:03 +00:00
|
|
|
/// Old "yul" dialect. This is only used for testing.
|
|
|
|
static Dialect const& yulDeprecated();
|
2018-12-03 14:49:23 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
}
|