solidity/libsolidity/ast/ASTAnnotations.h

253 lines
7.4 KiB
C
Raw Normal View History

/*
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/>.
*/
/**
* @author Christian <c@ethdev.com>
* @date 2015
* Object containing the type and other annotations for the AST nodes.
*/
#pragma once
#include <libsolidity/ast/ASTForward.h>
#include <libsolidity/ast/ASTEnums.h>
2017-08-08 13:09:57 +00:00
#include <libsolidity/ast/ExperimentalFeatures.h>
#include <map>
#include <memory>
#include <optional>
2015-10-07 13:57:17 +00:00
#include <set>
2018-12-17 14:33:15 +00:00
#include <vector>
2019-12-11 16:31:36 +00:00
namespace solidity::yul
{
struct AsmAnalysisInfo;
struct Identifier;
struct Dialect;
}
2019-12-11 16:31:36 +00:00
namespace solidity::frontend
{
class Type;
using TypePointer = Type const*;
struct ASTAnnotation
{
virtual ~ASTAnnotation() = default;
2015-09-21 16:55:58 +00:00
};
2015-10-26 14:13:36 +00:00
struct DocTag
{
std::string content; ///< The text content of the tag.
std::string paramName; ///< Only used for @param, stores the parameter name.
};
struct DocumentedAnnotation
{
virtual ~DocumentedAnnotation() = default;
2015-10-26 14:13:36 +00:00
/// Mapping docstring tag name -> content.
std::multimap<std::string, DocTag> docTags;
};
2015-12-15 14:46:03 +00:00
struct SourceUnitAnnotation: ASTAnnotation
{
/// The "absolute" (in the compiler sense) path of this source unit.
std::string path;
/// The exported symbols (all global symbols).
std::map<ASTString, std::vector<Declaration const*>> exportedSymbols;
2017-08-08 13:09:57 +00:00
/// Experimental features.
std::set<ExperimentalFeature> experimentalFeatures;
2015-12-15 14:46:03 +00:00
};
2019-12-19 23:01:43 +00:00
struct ScopableAnnotation
{
/// The scope this declaration resides in. Can be nullptr if it is the global scope.
/// Available only after name and type resolution step.
ASTNode const* scope = nullptr;
};
2019-12-19 23:04:46 +00:00
struct DeclarationAnnotation: ASTAnnotation, ScopableAnnotation
{
};
struct ImportAnnotation: DeclarationAnnotation
2015-12-09 16:35:20 +00:00
{
/// The absolute path of the source unit to import.
std::string absolutePath;
2015-12-15 14:46:03 +00:00
/// The actual source unit.
SourceUnit const* sourceUnit = nullptr;
2015-12-09 16:35:20 +00:00
};
struct TypeDeclarationAnnotation: DeclarationAnnotation
{
/// The name of this type, prefixed by proper namespaces if globally accessible.
std::string canonicalName;
};
2015-10-26 14:13:36 +00:00
struct ContractDefinitionAnnotation: TypeDeclarationAnnotation, DocumentedAnnotation
2015-09-21 16:55:58 +00:00
{
/// List of functions without a body. Can also contain functions from base classes.
std::vector<FunctionDefinition const*> unimplementedFunctions;
2015-09-21 16:55:58 +00:00
/// List of all (direct and indirect) base contracts in order from derived to
/// base, including the contract itself.
std::vector<ContractDefinition const*> linearizedBaseContracts;
2015-10-07 13:57:17 +00:00
/// List of contracts this contract creates, i.e. which need to be compiled first.
/// Also includes all contracts from @a linearizedBaseContracts.
std::set<ContractDefinition const*> contractDependencies;
/// Mapping containing the nodes that define the arguments for base constructors.
/// These can either be inheritance specifiers or modifier invocations.
std::map<FunctionDefinition const*, ASTNode const*> baseConstructorArguments;
2015-09-21 16:55:58 +00:00
};
struct CallableDeclarationAnnotation: DeclarationAnnotation
{
/// The set of functions/modifiers/events this callable overrides.
std::set<CallableDeclaration const*> baseFunctions;
};
struct FunctionDefinitionAnnotation: CallableDeclarationAnnotation, DocumentedAnnotation
2015-10-26 14:13:36 +00:00
{
2019-09-16 12:33:43 +00:00
/// Pointer to the contract this function is defined in
ContractDefinition const* contract = nullptr;
2015-10-26 14:13:36 +00:00
};
struct EventDefinitionAnnotation: CallableDeclarationAnnotation, DocumentedAnnotation
2015-10-26 14:13:36 +00:00
{
};
struct ModifierDefinitionAnnotation: CallableDeclarationAnnotation, DocumentedAnnotation
2015-10-26 14:13:36 +00:00
{
};
struct VariableDeclarationAnnotation: DeclarationAnnotation
2015-09-21 16:55:58 +00:00
{
/// Type of variable (type of identifier referencing this variable).
TypePointer type = nullptr;
2019-12-10 08:48:01 +00:00
/// The set of functions this (public state) variable overrides.
std::set<CallableDeclaration const*> baseFunctions;
2015-09-21 16:55:58 +00:00
};
2015-10-26 16:20:29 +00:00
struct StatementAnnotation: ASTAnnotation, DocumentedAnnotation
{
};
struct InlineAssemblyAnnotation: StatementAnnotation
{
struct ExternalIdentifierInfo
{
Declaration const* declaration = nullptr;
2017-04-21 17:13:46 +00:00
bool isSlot = false; ///< Whether the storage slot of a variable is queried.
bool isOffset = false; ///< Whether the intra-slot offset of a storage variable is queried.
size_t valueSize = size_t(-1);
};
/// Mapping containing resolved references to external identifiers and their value size
std::map<yul::Identifier const*, ExternalIdentifierInfo> externalReferences;
/// Information generated during analysis phase.
std::shared_ptr<yul::AsmAnalysisInfo> analysisInfo;
};
2019-12-20 01:20:27 +00:00
struct BlockAnnotation: StatementAnnotation, ScopableAnnotation
{
};
struct TryCatchClauseAnnotation: ASTAnnotation, ScopableAnnotation
{
};
struct ForStatementAnnotation: StatementAnnotation, ScopableAnnotation
{
};
2015-10-26 16:20:29 +00:00
struct ReturnAnnotation: StatementAnnotation
2015-09-21 16:55:58 +00:00
{
/// Reference to the return parameters of the function.
ParameterList const* functionReturnParameters = nullptr;
};
struct TypeNameAnnotation: ASTAnnotation
{
/// Type declared by this type name, i.e. type of a variable where this type name is used.
/// Set during reference resolution stage.
TypePointer type = nullptr;
2015-09-21 16:55:58 +00:00
};
struct UserDefinedTypeNameAnnotation: TypeNameAnnotation
{
/// Referenced declaration, set during reference resolution stage.
Declaration const* referencedDeclaration = nullptr;
/// Stores a reference to the current contract.
/// This is needed because types of base contracts change depending on the context.
ContractDefinition const* contractScope = nullptr;
2015-09-21 16:55:58 +00:00
};
2015-09-21 16:55:58 +00:00
struct ExpressionAnnotation: ASTAnnotation
{
/// Inferred type of the expression.
TypePointer type = nullptr;
/// Whether the expression is a constant variable
bool isConstant = false;
2017-03-01 18:12:40 +00:00
/// Whether the expression is pure, i.e. compile-time constant.
bool isPure = false;
2015-09-21 16:55:58 +00:00
/// Whether it is an LValue (i.e. something that can be assigned to).
bool isLValue = false;
2015-09-21 16:55:58 +00:00
/// Whether the expression is used in a context where the LValue is actually required.
bool lValueRequested = false;
/// Types and - if given - names of arguments if the expr. is a function
/// that is called, used for overload resoultion
std::optional<FuncCallArguments> arguments;
2015-09-21 16:55:58 +00:00
};
struct IdentifierAnnotation: ExpressionAnnotation
{
/// Referenced declaration, set at latest during overload resolution stage.
Declaration const* referencedDeclaration = nullptr;
2015-09-21 16:55:58 +00:00
/// List of possible declarations it could refer to.
std::vector<Declaration const*> overloadedDeclarations;
2015-09-21 16:55:58 +00:00
};
struct MemberAccessAnnotation: ExpressionAnnotation
{
/// Referenced declaration, set at latest during overload resolution stage.
Declaration const* referencedDeclaration = nullptr;
};
struct BinaryOperationAnnotation: ExpressionAnnotation
{
/// The common type that is used for the operation, not necessarily the result type (which
/// e.g. for comparisons is bool).
TypePointer commonType = nullptr;
2015-09-21 16:55:58 +00:00
};
2017-05-19 13:45:01 +00:00
enum class FunctionCallKind
{
Unset,
FunctionCall,
TypeConversion,
StructConstructorCall
};
2015-09-21 16:55:58 +00:00
struct FunctionCallAnnotation: ExpressionAnnotation
{
2017-05-19 13:45:01 +00:00
FunctionCallKind kind = FunctionCallKind::Unset;
2019-09-02 14:17:02 +00:00
/// If true, this is the external call of a try statement.
bool tryCall = false;
};
}