mirror of
https://github.com/ethereum/solidity
synced 2023-10-03 13:03:40 +00:00
99 lines
3.3 KiB
C++
99 lines
3.3 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
|
|
/**
|
|
* Optimiser component that turns subsequent assignments to variable declarations
|
|
* and assignments.
|
|
*/
|
|
#pragma once
|
|
|
|
#include <libyul/ASTForward.h>
|
|
#include <libyul/optimiser/ASTWalker.h>
|
|
#include <libyul/optimiser/OptimiserStep.h>
|
|
|
|
#include <liblangutil/SourceLocation.h>
|
|
|
|
#include <vector>
|
|
|
|
namespace solidity::yul
|
|
{
|
|
|
|
class NameDispenser;
|
|
|
|
/**
|
|
* Optimizer stage that tries to replace repeated assignments to
|
|
* existing variables by declarations of new variables as much as
|
|
* possible.
|
|
* The reassignments are still there, but all references to the
|
|
* reassigned variables are replaced by the newly declared variables.
|
|
*
|
|
* Example:
|
|
* {
|
|
* let a := 1
|
|
* mstore(a, 2)
|
|
* a := 3
|
|
* }
|
|
* is transformed to
|
|
* {
|
|
* let a_1 := 1
|
|
* let a := a_1
|
|
* mstore(a_1, 2)
|
|
* let a_3 := 3
|
|
* a := a_3
|
|
* }
|
|
*
|
|
* Exact semantics:
|
|
*
|
|
* For any variable a that is assigned to somewhere in the code (assignment with
|
|
* declaration does not count) perform the following transforms:
|
|
* - replace "let a := v" by "let a_1 := v let a := a_1"
|
|
* - replace "a := v" by "let a_1 := v a := a_1"
|
|
* Furthermore, always note the current variable/value assigned to a and replace each
|
|
* reference to a by this variable.
|
|
* The current value mapping is cleared for a variable a at the end of each block
|
|
* in which it was assigned. We compensate that by appending a declaration
|
|
* of the form of "let a_1 := a" right after the location where control flow joins so
|
|
* variable references can use the SSA variable. The only exception to this rule are
|
|
* for loop conditions, as we cannot insert a variable declaration there.
|
|
*
|
|
* After this stage, UnusedAssignmentEliminator is recommended to remove the unnecessary
|
|
* intermediate assignments.
|
|
*
|
|
* This stage provides best results if CSE is run right before it, because
|
|
* then it does not generate excessive amounts of variables.
|
|
*
|
|
* The transform is implemented in three stages. All stages are only concerned
|
|
* with variables that are assigned somewhere in the code (excluding declarations).
|
|
* The first stage inserts new SSA variables for each declaration and assignment of
|
|
* such variables.
|
|
* The second stage inserts new SSA variables at control flow joins.
|
|
* The last stage replaces references to variables that are assigned to somewhere in the
|
|
* code by their current SSA variable.
|
|
*
|
|
* TODO Which transforms are required to keep this idempotent?
|
|
*
|
|
* Prerequisite: Disambiguator, ForLoopInitRewriter.
|
|
*/
|
|
class SSATransform: public ASTModifier
|
|
{
|
|
public:
|
|
static constexpr char const* name{"SSATransform"};
|
|
static void run(OptimiserStepContext& _context, Block& _ast);
|
|
};
|
|
|
|
}
|