blob: 37a06b49ec6d002d3bb107d85b525c6b4b0f5a9b [file] [log] [blame]
John Stiles44e96be2020-08-31 13:16:04 -04001/*
2 * Copyright 2020 Google LLC
3 *
4 * Use of this source code is governed by a BSD-style license that can be
5 * found in the LICENSE file.
6 */
7
8#include "src/sksl/SkSLInliner.h"
9
John Stiles2d7973a2020-10-02 15:01:03 -040010#include <limits.h>
John Stiles44e96be2020-08-31 13:16:04 -040011#include <memory>
12#include <unordered_set>
13
14#include "src/sksl/SkSLAnalysis.h"
15#include "src/sksl/ir/SkSLBinaryExpression.h"
16#include "src/sksl/ir/SkSLBoolLiteral.h"
17#include "src/sksl/ir/SkSLBreakStatement.h"
18#include "src/sksl/ir/SkSLConstructor.h"
19#include "src/sksl/ir/SkSLContinueStatement.h"
20#include "src/sksl/ir/SkSLDiscardStatement.h"
21#include "src/sksl/ir/SkSLDoStatement.h"
22#include "src/sksl/ir/SkSLEnum.h"
23#include "src/sksl/ir/SkSLExpressionStatement.h"
24#include "src/sksl/ir/SkSLExternalFunctionCall.h"
Brian Osmanbe0b3b72021-01-06 14:27:35 -050025#include "src/sksl/ir/SkSLExternalFunctionReference.h"
John Stiles44e96be2020-08-31 13:16:04 -040026#include "src/sksl/ir/SkSLField.h"
27#include "src/sksl/ir/SkSLFieldAccess.h"
28#include "src/sksl/ir/SkSLFloatLiteral.h"
29#include "src/sksl/ir/SkSLForStatement.h"
30#include "src/sksl/ir/SkSLFunctionCall.h"
31#include "src/sksl/ir/SkSLFunctionDeclaration.h"
32#include "src/sksl/ir/SkSLFunctionDefinition.h"
33#include "src/sksl/ir/SkSLFunctionReference.h"
34#include "src/sksl/ir/SkSLIfStatement.h"
35#include "src/sksl/ir/SkSLIndexExpression.h"
John Stiles98c1f822020-09-09 14:18:53 -040036#include "src/sksl/ir/SkSLInlineMarker.h"
John Stiles44e96be2020-08-31 13:16:04 -040037#include "src/sksl/ir/SkSLIntLiteral.h"
38#include "src/sksl/ir/SkSLInterfaceBlock.h"
39#include "src/sksl/ir/SkSLLayout.h"
40#include "src/sksl/ir/SkSLNop.h"
John Stiles44e96be2020-08-31 13:16:04 -040041#include "src/sksl/ir/SkSLPostfixExpression.h"
42#include "src/sksl/ir/SkSLPrefixExpression.h"
43#include "src/sksl/ir/SkSLReturnStatement.h"
44#include "src/sksl/ir/SkSLSetting.h"
45#include "src/sksl/ir/SkSLSwitchCase.h"
46#include "src/sksl/ir/SkSLSwitchStatement.h"
47#include "src/sksl/ir/SkSLSwizzle.h"
48#include "src/sksl/ir/SkSLTernaryExpression.h"
49#include "src/sksl/ir/SkSLUnresolvedFunction.h"
50#include "src/sksl/ir/SkSLVarDeclarations.h"
John Stiles44e96be2020-08-31 13:16:04 -040051#include "src/sksl/ir/SkSLVariable.h"
52#include "src/sksl/ir/SkSLVariableReference.h"
John Stiles44e96be2020-08-31 13:16:04 -040053
54namespace SkSL {
55namespace {
56
John Stiles031a7672020-11-13 16:13:18 -050057static constexpr int kInlinedStatementLimit = 2500;
58
John Stiles44e96be2020-08-31 13:16:04 -040059static int count_returns_at_end_of_control_flow(const FunctionDefinition& funcDef) {
60 class CountReturnsAtEndOfControlFlow : public ProgramVisitor {
61 public:
62 CountReturnsAtEndOfControlFlow(const FunctionDefinition& funcDef) {
63 this->visitProgramElement(funcDef);
64 }
65
66 bool visitStatement(const Statement& stmt) override {
Ethan Nicholase6592142020-09-08 10:22:09 -040067 switch (stmt.kind()) {
68 case Statement::Kind::kBlock: {
John Stiles44e96be2020-08-31 13:16:04 -040069 // Check only the last statement of a block.
Ethan Nicholas7bd60432020-09-25 14:31:59 -040070 const auto& block = stmt.as<Block>();
71 return block.children().size() &&
72 this->visitStatement(*block.children().back());
John Stiles44e96be2020-08-31 13:16:04 -040073 }
Ethan Nicholase6592142020-09-08 10:22:09 -040074 case Statement::Kind::kSwitch:
Ethan Nicholase6592142020-09-08 10:22:09 -040075 case Statement::Kind::kDo:
76 case Statement::Kind::kFor:
John Stiles44e96be2020-08-31 13:16:04 -040077 // Don't introspect switches or loop structures at all.
78 return false;
79
Ethan Nicholase6592142020-09-08 10:22:09 -040080 case Statement::Kind::kReturn:
John Stiles44e96be2020-08-31 13:16:04 -040081 ++fNumReturns;
82 [[fallthrough]];
83
84 default:
John Stiles93442622020-09-11 12:11:27 -040085 return INHERITED::visitStatement(stmt);
John Stiles44e96be2020-08-31 13:16:04 -040086 }
87 }
88
89 int fNumReturns = 0;
90 using INHERITED = ProgramVisitor;
91 };
92
93 return CountReturnsAtEndOfControlFlow{funcDef}.fNumReturns;
94}
95
John Stiles74ebd7e2020-12-17 14:41:50 -050096static int count_returns_in_continuable_constructs(const FunctionDefinition& funcDef) {
97 class CountReturnsInContinuableConstructs : public ProgramVisitor {
John Stiles44e96be2020-08-31 13:16:04 -040098 public:
John Stiles74ebd7e2020-12-17 14:41:50 -050099 CountReturnsInContinuableConstructs(const FunctionDefinition& funcDef) {
John Stiles44e96be2020-08-31 13:16:04 -0400100 this->visitProgramElement(funcDef);
101 }
102
103 bool visitStatement(const Statement& stmt) override {
Ethan Nicholase6592142020-09-08 10:22:09 -0400104 switch (stmt.kind()) {
Ethan Nicholase6592142020-09-08 10:22:09 -0400105 case Statement::Kind::kDo:
106 case Statement::Kind::kFor: {
John Stiles74ebd7e2020-12-17 14:41:50 -0500107 ++fInsideContinuableConstruct;
John Stiles93442622020-09-11 12:11:27 -0400108 bool result = INHERITED::visitStatement(stmt);
John Stiles74ebd7e2020-12-17 14:41:50 -0500109 --fInsideContinuableConstruct;
John Stiles44e96be2020-08-31 13:16:04 -0400110 return result;
111 }
112
Ethan Nicholase6592142020-09-08 10:22:09 -0400113 case Statement::Kind::kReturn:
John Stiles74ebd7e2020-12-17 14:41:50 -0500114 fNumReturns += (fInsideContinuableConstruct > 0) ? 1 : 0;
John Stiles44e96be2020-08-31 13:16:04 -0400115 [[fallthrough]];
116
117 default:
John Stiles93442622020-09-11 12:11:27 -0400118 return INHERITED::visitStatement(stmt);
John Stiles44e96be2020-08-31 13:16:04 -0400119 }
120 }
121
122 int fNumReturns = 0;
John Stiles74ebd7e2020-12-17 14:41:50 -0500123 int fInsideContinuableConstruct = 0;
John Stiles44e96be2020-08-31 13:16:04 -0400124 using INHERITED = ProgramVisitor;
125 };
126
John Stiles74ebd7e2020-12-17 14:41:50 -0500127 return CountReturnsInContinuableConstructs{funcDef}.fNumReturns;
John Stiles44e96be2020-08-31 13:16:04 -0400128}
129
John Stiles991b09d2020-09-10 13:33:40 -0400130static bool contains_recursive_call(const FunctionDeclaration& funcDecl) {
131 class ContainsRecursiveCall : public ProgramVisitor {
132 public:
133 bool visit(const FunctionDeclaration& funcDecl) {
134 fFuncDecl = &funcDecl;
Ethan Nicholased84b732020-10-08 11:45:44 -0400135 return funcDecl.definition() ? this->visitProgramElement(*funcDecl.definition())
136 : false;
John Stiles991b09d2020-09-10 13:33:40 -0400137 }
138
139 bool visitExpression(const Expression& expr) override {
Ethan Nicholas0dec9922020-10-05 15:51:52 -0400140 if (expr.is<FunctionCall>() && expr.as<FunctionCall>().function().matches(*fFuncDecl)) {
John Stiles991b09d2020-09-10 13:33:40 -0400141 return true;
142 }
143 return INHERITED::visitExpression(expr);
144 }
145
146 bool visitStatement(const Statement& stmt) override {
Ethan Nicholasceb62142020-10-09 16:51:18 -0400147 if (stmt.is<InlineMarker>() &&
148 stmt.as<InlineMarker>().function().matches(*fFuncDecl)) {
John Stiles991b09d2020-09-10 13:33:40 -0400149 return true;
150 }
151 return INHERITED::visitStatement(stmt);
152 }
153
154 const FunctionDeclaration* fFuncDecl;
155 using INHERITED = ProgramVisitor;
156 };
157
158 return ContainsRecursiveCall{}.visit(funcDecl);
159}
160
John Stiles6d696082020-10-01 10:18:54 -0400161static std::unique_ptr<Statement>* find_parent_statement(
162 const std::vector<std::unique_ptr<Statement>*>& stmtStack) {
John Stiles915a38c2020-09-14 09:38:13 -0400163 SkASSERT(!stmtStack.empty());
164
165 // Walk the statement stack from back to front, ignoring the last element (which is the
166 // enclosing statement).
167 auto iter = stmtStack.rbegin();
168 ++iter;
169
170 // Anything counts as a parent statement other than a scopeless Block.
171 for (; iter != stmtStack.rend(); ++iter) {
John Stiles6d696082020-10-01 10:18:54 -0400172 std::unique_ptr<Statement>* stmt = *iter;
173 if (!(*stmt)->is<Block>() || (*stmt)->as<Block>().isScope()) {
John Stiles915a38c2020-09-14 09:38:13 -0400174 return stmt;
175 }
176 }
177
178 // There wasn't any parent statement to be found.
179 return nullptr;
180}
181
John Stilese41b4ee2020-09-28 12:28:16 -0400182std::unique_ptr<Expression> clone_with_ref_kind(const Expression& expr,
183 VariableReference::RefKind refKind) {
184 std::unique_ptr<Expression> clone = expr.clone();
John Stiles47c0a742021-02-09 09:30:35 -0500185 Analysis::UpdateRefKind(clone.get(), refKind);
John Stilese41b4ee2020-09-28 12:28:16 -0400186 return clone;
187}
188
John Stiles77702f12020-12-17 14:38:56 -0500189class CountReturnsWithLimit : public ProgramVisitor {
190public:
191 CountReturnsWithLimit(const FunctionDefinition& funcDef, int limit) : fLimit(limit) {
192 this->visitProgramElement(funcDef);
193 }
194
195 bool visitStatement(const Statement& stmt) override {
196 switch (stmt.kind()) {
197 case Statement::Kind::kReturn: {
198 ++fNumReturns;
199 fDeepestReturn = std::max(fDeepestReturn, fScopedBlockDepth);
200 return (fNumReturns >= fLimit) || INHERITED::visitStatement(stmt);
201 }
John Stilesc5ff4862020-12-22 13:47:05 -0500202 case Statement::Kind::kVarDeclaration: {
203 if (fScopedBlockDepth > 1) {
204 fVariablesInBlocks = true;
205 }
206 return INHERITED::visitStatement(stmt);
207 }
John Stiles77702f12020-12-17 14:38:56 -0500208 case Statement::Kind::kBlock: {
209 int depthIncrement = stmt.as<Block>().isScope() ? 1 : 0;
210 fScopedBlockDepth += depthIncrement;
211 bool result = INHERITED::visitStatement(stmt);
212 fScopedBlockDepth -= depthIncrement;
John Stilesc5ff4862020-12-22 13:47:05 -0500213 if (fNumReturns == 0 && fScopedBlockDepth <= 1) {
214 // If closing this block puts us back at the top level, and we haven't
215 // encountered any return statements yet, any vardecls we may have encountered
216 // up until this point can be ignored. They are out of scope now, and they were
217 // never used in a return statement.
218 fVariablesInBlocks = false;
219 }
John Stiles77702f12020-12-17 14:38:56 -0500220 return result;
221 }
222 default:
223 return INHERITED::visitStatement(stmt);
224 }
225 }
226
227 int fNumReturns = 0;
228 int fDeepestReturn = 0;
229 int fLimit = 0;
230 int fScopedBlockDepth = 0;
John Stilesc5ff4862020-12-22 13:47:05 -0500231 bool fVariablesInBlocks = false;
John Stiles77702f12020-12-17 14:38:56 -0500232 using INHERITED = ProgramVisitor;
233};
234
John Stiles44e96be2020-08-31 13:16:04 -0400235} // namespace
236
John Stiles77702f12020-12-17 14:38:56 -0500237Inliner::ReturnComplexity Inliner::GetReturnComplexity(const FunctionDefinition& funcDef) {
238 int returnsAtEndOfControlFlow = count_returns_at_end_of_control_flow(funcDef);
239 CountReturnsWithLimit counter{funcDef, returnsAtEndOfControlFlow + 1};
John Stiles77702f12020-12-17 14:38:56 -0500240 if (counter.fNumReturns > returnsAtEndOfControlFlow) {
241 return ReturnComplexity::kEarlyReturns;
242 }
John Stilesc5ff4862020-12-22 13:47:05 -0500243 if (counter.fNumReturns > 1) {
John Stiles77702f12020-12-17 14:38:56 -0500244 return ReturnComplexity::kScopedReturns;
245 }
John Stilesc5ff4862020-12-22 13:47:05 -0500246 if (counter.fVariablesInBlocks && counter.fDeepestReturn > 1) {
247 return ReturnComplexity::kScopedReturns;
248 }
249 return ReturnComplexity::kSingleSafeReturn;
John Stiles77702f12020-12-17 14:38:56 -0500250}
251
John Stilesb61ee902020-09-21 12:26:59 -0400252void Inliner::ensureScopedBlocks(Statement* inlinedBody, Statement* parentStmt) {
253 // No changes necessary if this statement isn't actually a block.
254 if (!inlinedBody || !inlinedBody->is<Block>()) {
255 return;
256 }
257
258 // No changes necessary if the parent statement doesn't require a scope.
259 if (!parentStmt || !(parentStmt->is<IfStatement>() || parentStmt->is<ForStatement>() ||
Brian Osmand6f23382020-12-15 17:08:59 -0500260 parentStmt->is<DoStatement>())) {
John Stilesb61ee902020-09-21 12:26:59 -0400261 return;
262 }
263
264 Block& block = inlinedBody->as<Block>();
265
266 // The inliner will create inlined function bodies as a Block containing multiple statements,
267 // but no scope. Normally, this is fine, but if this block is used as the statement for a
268 // do/for/if/while, this isn't actually possible to represent textually; a scope must be added
269 // for the generated code to match the intent. In the case of Blocks nested inside other Blocks,
270 // we add the scope to the outermost block if needed. Zero-statement blocks have similar
271 // issues--if we don't represent the Block textually somehow, we run the risk of accidentally
272 // absorbing the following statement into our loop--so we also add a scope to these.
273 for (Block* nestedBlock = &block;; ) {
Ethan Nicholas7bd60432020-09-25 14:31:59 -0400274 if (nestedBlock->isScope()) {
John Stilesb61ee902020-09-21 12:26:59 -0400275 // We found an explicit scope; all is well.
276 return;
277 }
Ethan Nicholas7bd60432020-09-25 14:31:59 -0400278 if (nestedBlock->children().size() != 1) {
John Stilesb61ee902020-09-21 12:26:59 -0400279 // We found a block with multiple (or zero) statements, but no scope? Let's add a scope
280 // to the outermost block.
Ethan Nicholas7bd60432020-09-25 14:31:59 -0400281 block.setIsScope(true);
John Stilesb61ee902020-09-21 12:26:59 -0400282 return;
283 }
Ethan Nicholas7bd60432020-09-25 14:31:59 -0400284 if (!nestedBlock->children()[0]->is<Block>()) {
John Stilesb61ee902020-09-21 12:26:59 -0400285 // This block has exactly one thing inside, and it's not another block. No need to scope
286 // it.
287 return;
288 }
289 // We have to go deeper.
Ethan Nicholas7bd60432020-09-25 14:31:59 -0400290 nestedBlock = &nestedBlock->children()[0]->as<Block>();
John Stilesb61ee902020-09-21 12:26:59 -0400291 }
292}
293
John Stilesd1204642021-02-17 16:30:02 -0500294void Inliner::reset(ModifiersPool* modifiers) {
Ethan Nicholas041fd0a2020-10-07 16:42:04 -0400295 fModifiers = modifiers;
Ethan Nicholas6f4eee22021-01-11 12:37:42 -0500296 fMangler.reset();
John Stiles031a7672020-11-13 16:13:18 -0500297 fInlinedStatementCounter = 0;
John Stiles44e96be2020-08-31 13:16:04 -0400298}
299
300std::unique_ptr<Expression> Inliner::inlineExpression(int offset,
301 VariableRewriteMap* varMap,
John Stilesd7cc0932020-11-30 12:24:27 -0500302 SymbolTable* symbolTableForExpression,
John Stiles44e96be2020-08-31 13:16:04 -0400303 const Expression& expression) {
304 auto expr = [&](const std::unique_ptr<Expression>& e) -> std::unique_ptr<Expression> {
305 if (e) {
John Stilesd7cc0932020-11-30 12:24:27 -0500306 return this->inlineExpression(offset, varMap, symbolTableForExpression, *e);
John Stiles44e96be2020-08-31 13:16:04 -0400307 }
308 return nullptr;
309 };
John Stiles8e3b6be2020-10-13 11:14:08 -0400310 auto argList = [&](const ExpressionArray& originalArgs) -> ExpressionArray {
311 ExpressionArray args;
John Stilesf4bda742020-10-14 16:57:41 -0400312 args.reserve_back(originalArgs.size());
John Stiles44e96be2020-08-31 13:16:04 -0400313 for (const std::unique_ptr<Expression>& arg : originalArgs) {
314 args.push_back(expr(arg));
315 }
316 return args;
317 };
318
Ethan Nicholase6592142020-09-08 10:22:09 -0400319 switch (expression.kind()) {
320 case Expression::Kind::kBinary: {
John Stiles6a1a98c2021-01-14 18:35:34 -0500321 const BinaryExpression& binaryExpr = expression.as<BinaryExpression>();
John Stilese2aec432021-03-01 09:27:48 -0500322 return BinaryExpression::Make(*fContext,
323 expr(binaryExpr.left()),
324 binaryExpr.getOperator(),
325 expr(binaryExpr.right()));
John Stiles44e96be2020-08-31 13:16:04 -0400326 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400327 case Expression::Kind::kBoolLiteral:
328 case Expression::Kind::kIntLiteral:
329 case Expression::Kind::kFloatLiteral:
John Stiles44e96be2020-08-31 13:16:04 -0400330 return expression.clone();
Ethan Nicholase6592142020-09-08 10:22:09 -0400331 case Expression::Kind::kConstructor: {
John Stiles44e96be2020-08-31 13:16:04 -0400332 const Constructor& constructor = expression.as<Constructor>();
John Stiles54f00492021-02-19 11:46:10 -0500333 return Constructor::Make(*fContext, offset,
334 *constructor.type().clone(symbolTableForExpression),
335 argList(constructor.arguments()));
John Stiles44e96be2020-08-31 13:16:04 -0400336 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400337 case Expression::Kind::kExternalFunctionCall: {
John Stiles44e96be2020-08-31 13:16:04 -0400338 const ExternalFunctionCall& externalCall = expression.as<ExternalFunctionCall>();
Ethan Nicholas444ccc62020-10-09 10:16:22 -0400339 return std::make_unique<ExternalFunctionCall>(offset, &externalCall.function(),
Ethan Nicholas6e86ec92020-09-30 14:29:56 -0400340 argList(externalCall.arguments()));
John Stiles44e96be2020-08-31 13:16:04 -0400341 }
Brian Osmanbe0b3b72021-01-06 14:27:35 -0500342 case Expression::Kind::kExternalFunctionReference:
John Stiles44e96be2020-08-31 13:16:04 -0400343 return expression.clone();
Ethan Nicholase6592142020-09-08 10:22:09 -0400344 case Expression::Kind::kFieldAccess: {
John Stiles44e96be2020-08-31 13:16:04 -0400345 const FieldAccess& f = expression.as<FieldAccess>();
Ethan Nicholas7a95b202020-10-09 11:55:40 -0400346 return std::make_unique<FieldAccess>(expr(f.base()), f.fieldIndex(), f.ownerKind());
John Stiles44e96be2020-08-31 13:16:04 -0400347 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400348 case Expression::Kind::kFunctionCall: {
John Stiles44e96be2020-08-31 13:16:04 -0400349 const FunctionCall& funcCall = expression.as<FunctionCall>();
John Stilesddcc8432021-01-15 15:32:32 -0500350 return std::make_unique<FunctionCall>(offset,
351 funcCall.type().clone(symbolTableForExpression),
352 &funcCall.function(),
Ethan Nicholas0dec9922020-10-05 15:51:52 -0400353 argList(funcCall.arguments()));
John Stiles44e96be2020-08-31 13:16:04 -0400354 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400355 case Expression::Kind::kFunctionReference:
Brian Osman2b3b35f2020-09-08 09:17:36 -0400356 return expression.clone();
Ethan Nicholase6592142020-09-08 10:22:09 -0400357 case Expression::Kind::kIndex: {
John Stiles44e96be2020-08-31 13:16:04 -0400358 const IndexExpression& idx = expression.as<IndexExpression>();
Ethan Nicholas2a4952d2020-10-08 15:35:56 -0400359 return std::make_unique<IndexExpression>(*fContext, expr(idx.base()),
360 expr(idx.index()));
John Stiles44e96be2020-08-31 13:16:04 -0400361 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400362 case Expression::Kind::kPrefix: {
John Stiles44e96be2020-08-31 13:16:04 -0400363 const PrefixExpression& p = expression.as<PrefixExpression>();
John Stilesb0eb20f2021-02-26 15:29:33 -0500364 return PrefixExpression::Make(*fContext, p.getOperator(), expr(p.operand()));
John Stiles44e96be2020-08-31 13:16:04 -0400365 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400366 case Expression::Kind::kPostfix: {
John Stiles44e96be2020-08-31 13:16:04 -0400367 const PostfixExpression& p = expression.as<PostfixExpression>();
John Stiles52d3b012021-02-26 15:56:48 -0500368 return PostfixExpression::Make(*fContext, expr(p.operand()), p.getOperator());
John Stiles44e96be2020-08-31 13:16:04 -0400369 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400370 case Expression::Kind::kSetting:
John Stiles44e96be2020-08-31 13:16:04 -0400371 return expression.clone();
Ethan Nicholase6592142020-09-08 10:22:09 -0400372 case Expression::Kind::kSwizzle: {
John Stiles44e96be2020-08-31 13:16:04 -0400373 const Swizzle& s = expression.as<Swizzle>();
John Stiles6e88e042021-02-19 14:09:38 -0500374 return Swizzle::Make(*fContext, expr(s.base()), s.components());
John Stiles44e96be2020-08-31 13:16:04 -0400375 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400376 case Expression::Kind::kTernary: {
John Stiles44e96be2020-08-31 13:16:04 -0400377 const TernaryExpression& t = expression.as<TernaryExpression>();
John Stiles90518f72021-02-26 20:44:54 -0500378 return TernaryExpression::Make(*fContext, expr(t.test()),
379 expr(t.ifTrue()), expr(t.ifFalse()));
John Stiles44e96be2020-08-31 13:16:04 -0400380 }
Brian Osman83ba9302020-09-11 13:33:46 -0400381 case Expression::Kind::kTypeReference:
382 return expression.clone();
Ethan Nicholase6592142020-09-08 10:22:09 -0400383 case Expression::Kind::kVariableReference: {
John Stiles44e96be2020-08-31 13:16:04 -0400384 const VariableReference& v = expression.as<VariableReference>();
Ethan Nicholas78686922020-10-08 06:46:27 -0400385 auto varMapIter = varMap->find(v.variable());
John Stilese41b4ee2020-09-28 12:28:16 -0400386 if (varMapIter != varMap->end()) {
Ethan Nicholas78686922020-10-08 06:46:27 -0400387 return clone_with_ref_kind(*varMapIter->second, v.refKind());
John Stiles44e96be2020-08-31 13:16:04 -0400388 }
389 return v.clone();
390 }
391 default:
392 SkASSERT(false);
393 return nullptr;
394 }
395}
396
397std::unique_ptr<Statement> Inliner::inlineStatement(int offset,
398 VariableRewriteMap* varMap,
399 SymbolTable* symbolTableForStatement,
John Stiles77702f12020-12-17 14:38:56 -0500400 std::unique_ptr<Expression>* resultExpr,
401 ReturnComplexity returnComplexity,
Brian Osman3887a012020-09-30 13:22:27 -0400402 const Statement& statement,
403 bool isBuiltinCode) {
John Stiles44e96be2020-08-31 13:16:04 -0400404 auto stmt = [&](const std::unique_ptr<Statement>& s) -> std::unique_ptr<Statement> {
405 if (s) {
John Stilesa5f3c312020-09-22 12:05:16 -0400406 return this->inlineStatement(offset, varMap, symbolTableForStatement, resultExpr,
John Stiles77702f12020-12-17 14:38:56 -0500407 returnComplexity, *s, isBuiltinCode);
John Stiles44e96be2020-08-31 13:16:04 -0400408 }
409 return nullptr;
410 };
Ethan Nicholas7bd60432020-09-25 14:31:59 -0400411 auto blockStmts = [&](const Block& block) {
John Stiles8f2a0cf2020-10-13 12:48:21 -0400412 StatementArray result;
John Stilesf4bda742020-10-14 16:57:41 -0400413 result.reserve_back(block.children().size());
Ethan Nicholas7bd60432020-09-25 14:31:59 -0400414 for (const std::unique_ptr<Statement>& child : block.children()) {
415 result.push_back(stmt(child));
416 }
417 return result;
418 };
John Stiles8f2a0cf2020-10-13 12:48:21 -0400419 auto stmts = [&](const StatementArray& ss) {
420 StatementArray result;
John Stilesf4bda742020-10-14 16:57:41 -0400421 result.reserve_back(ss.size());
John Stiles44e96be2020-08-31 13:16:04 -0400422 for (const auto& s : ss) {
423 result.push_back(stmt(s));
424 }
425 return result;
426 };
427 auto expr = [&](const std::unique_ptr<Expression>& e) -> std::unique_ptr<Expression> {
428 if (e) {
John Stilesd7cc0932020-11-30 12:24:27 -0500429 return this->inlineExpression(offset, varMap, symbolTableForStatement, *e);
John Stiles44e96be2020-08-31 13:16:04 -0400430 }
431 return nullptr;
432 };
John Stiles031a7672020-11-13 16:13:18 -0500433
434 ++fInlinedStatementCounter;
435
Ethan Nicholase6592142020-09-08 10:22:09 -0400436 switch (statement.kind()) {
437 case Statement::Kind::kBlock: {
John Stiles44e96be2020-08-31 13:16:04 -0400438 const Block& b = statement.as<Block>();
John Stilesa1e2b412020-10-20 14:51:28 -0400439 return std::make_unique<Block>(offset, blockStmts(b),
440 SymbolTable::WrapIfBuiltin(b.symbolTable()),
441 b.isScope());
John Stiles44e96be2020-08-31 13:16:04 -0400442 }
443
Ethan Nicholase6592142020-09-08 10:22:09 -0400444 case Statement::Kind::kBreak:
445 case Statement::Kind::kContinue:
446 case Statement::Kind::kDiscard:
John Stiles44e96be2020-08-31 13:16:04 -0400447 return statement.clone();
448
Ethan Nicholase6592142020-09-08 10:22:09 -0400449 case Statement::Kind::kDo: {
John Stiles44e96be2020-08-31 13:16:04 -0400450 const DoStatement& d = statement.as<DoStatement>();
John Stilesea5822e2021-02-26 11:18:20 -0500451 return DoStatement::Make(*fContext, stmt(d.statement()), expr(d.test()));
John Stiles44e96be2020-08-31 13:16:04 -0400452 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400453 case Statement::Kind::kExpression: {
John Stiles44e96be2020-08-31 13:16:04 -0400454 const ExpressionStatement& e = statement.as<ExpressionStatement>();
John Stiles3e5871c2021-02-25 20:52:03 -0500455 return ExpressionStatement::Make(*fContext, expr(e.expression()));
John Stiles44e96be2020-08-31 13:16:04 -0400456 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400457 case Statement::Kind::kFor: {
John Stiles44e96be2020-08-31 13:16:04 -0400458 const ForStatement& f = statement.as<ForStatement>();
459 // need to ensure initializer is evaluated first so that we've already remapped its
460 // declarations by the time we evaluate test & next
Ethan Nicholas0d31ed52020-10-05 14:47:09 -0400461 std::unique_ptr<Statement> initializer = stmt(f.initializer());
John Stilesb321a072021-02-25 16:24:19 -0500462 return ForStatement::Make(*fContext, offset, std::move(initializer), expr(f.test()),
463 expr(f.next()), stmt(f.statement()),
464 SymbolTable::WrapIfBuiltin(f.symbols()));
John Stiles44e96be2020-08-31 13:16:04 -0400465 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400466 case Statement::Kind::kIf: {
John Stiles44e96be2020-08-31 13:16:04 -0400467 const IfStatement& i = statement.as<IfStatement>();
John Stilescf3059e2021-02-25 14:27:02 -0500468 return IfStatement::Make(*fContext, offset, i.isStatic(), expr(i.test()),
469 stmt(i.ifTrue()), stmt(i.ifFalse()));
John Stiles44e96be2020-08-31 13:16:04 -0400470 }
John Stiles98c1f822020-09-09 14:18:53 -0400471 case Statement::Kind::kInlineMarker:
Ethan Nicholase6592142020-09-08 10:22:09 -0400472 case Statement::Kind::kNop:
John Stiles44e96be2020-08-31 13:16:04 -0400473 return statement.clone();
John Stilesea5822e2021-02-26 11:18:20 -0500474
Ethan Nicholase6592142020-09-08 10:22:09 -0400475 case Statement::Kind::kReturn: {
John Stiles44e96be2020-08-31 13:16:04 -0400476 const ReturnStatement& r = statement.as<ReturnStatement>();
John Stiles77702f12020-12-17 14:38:56 -0500477 if (!r.expression()) {
478 if (returnComplexity >= ReturnComplexity::kEarlyReturns) {
479 // This function doesn't return a value, but has early returns, so we've wrapped
480 // it in a for loop. Use a continue to jump to the end of the loop and "leave"
481 // the function.
John Stiles7b920442020-12-17 10:43:41 -0500482 return std::make_unique<ContinueStatement>(offset);
John Stiles44e96be2020-08-31 13:16:04 -0400483 } else {
John Stiles77702f12020-12-17 14:38:56 -0500484 // This function doesn't exit early or return a value. A return statement at the
485 // end is a no-op and can be treated as such.
John Stiles44e96be2020-08-31 13:16:04 -0400486 return std::make_unique<Nop>();
487 }
488 }
John Stiles77702f12020-12-17 14:38:56 -0500489
John Stilesc5ff4862020-12-22 13:47:05 -0500490 // If a function only contains a single return, and it doesn't reference variables from
491 // inside an Block's scope, we don't need to store the result in a variable at all. Just
492 // replace the function-call expression with the function's return expression.
John Stiles77702f12020-12-17 14:38:56 -0500493 SkASSERT(resultExpr);
John Stilesc5ff4862020-12-22 13:47:05 -0500494 if (returnComplexity <= ReturnComplexity::kSingleSafeReturn) {
John Stiles77702f12020-12-17 14:38:56 -0500495 *resultExpr = expr(r.expression());
496 return std::make_unique<Nop>();
497 }
498
499 // For more complex functions, assign their result into a variable.
John Stiles511c5002021-02-25 11:17:02 -0500500 SkASSERT(*resultExpr);
John Stiles3e5871c2021-02-25 20:52:03 -0500501 auto assignment = ExpressionStatement::Make(
502 *fContext,
John Stilese2aec432021-03-01 09:27:48 -0500503 BinaryExpression::Make(
504 *fContext,
505 clone_with_ref_kind(**resultExpr, VariableRefKind::kWrite),
John Stiles77702f12020-12-17 14:38:56 -0500506 Token::Kind::TK_EQ,
John Stilese2aec432021-03-01 09:27:48 -0500507 expr(r.expression())));
John Stiles77702f12020-12-17 14:38:56 -0500508
509 // Early returns are wrapped in a for loop; we need to synthesize a continue statement
510 // to "leave" the function.
511 if (returnComplexity >= ReturnComplexity::kEarlyReturns) {
512 StatementArray block;
513 block.reserve_back(2);
514 block.push_back(std::move(assignment));
515 block.push_back(std::make_unique<ContinueStatement>(offset));
516 return std::make_unique<Block>(offset, std::move(block), /*symbols=*/nullptr,
517 /*isScope=*/true);
518 }
519 // Functions without early returns aren't wrapped in a for loop and don't need to worry
520 // about breaking out of the control flow.
John Stiles3e5871c2021-02-25 20:52:03 -0500521 return assignment;
John Stiles44e96be2020-08-31 13:16:04 -0400522 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400523 case Statement::Kind::kSwitch: {
John Stiles44e96be2020-08-31 13:16:04 -0400524 const SwitchStatement& ss = statement.as<SwitchStatement>();
525 std::vector<std::unique_ptr<SwitchCase>> cases;
John Stiles2d4f9592020-10-30 10:29:12 -0400526 cases.reserve(ss.cases().size());
527 for (const std::unique_ptr<SwitchCase>& sc : ss.cases()) {
528 cases.push_back(std::make_unique<SwitchCase>(offset, expr(sc->value()),
529 stmts(sc->statements())));
John Stiles44e96be2020-08-31 13:16:04 -0400530 }
John Stilese1d1b082021-02-23 13:44:36 -0500531 return SwitchStatement::Make(*fContext, offset, ss.isStatic(), expr(ss.value()),
532 std::move(cases), SymbolTable::WrapIfBuiltin(ss.symbols()));
John Stiles44e96be2020-08-31 13:16:04 -0400533 }
Ethan Nicholase6592142020-09-08 10:22:09 -0400534 case Statement::Kind::kVarDeclaration: {
John Stiles44e96be2020-08-31 13:16:04 -0400535 const VarDeclaration& decl = statement.as<VarDeclaration>();
John Stiles35fee4c2020-12-16 18:25:14 +0000536 std::unique_ptr<Expression> initialValue = expr(decl.value());
John Stilesddcc8432021-01-15 15:32:32 -0500537 const Variable& variable = decl.var();
538
John Stiles35fee4c2020-12-16 18:25:14 +0000539 // We assign unique names to inlined variables--scopes hide most of the problems in this
540 // regard, but see `InlinerAvoidsVariableNameOverlap` for a counterexample where unique
541 // names are important.
John Stilesddcc8432021-01-15 15:32:32 -0500542 auto name = std::make_unique<String>(fMangler.uniqueName(variable.name(),
Ethan Nicholas6f4eee22021-01-11 12:37:42 -0500543 symbolTableForStatement));
John Stiles35fee4c2020-12-16 18:25:14 +0000544 const String* namePtr = symbolTableForStatement->takeOwnershipOfString(std::move(name));
Ethan Nicholas5b9b0db2021-01-21 13:12:01 -0500545 auto clonedVar = std::make_unique<Variable>(
546 offset,
547 &variable.modifiers(),
548 namePtr->c_str(),
549 variable.type().clone(symbolTableForStatement),
550 isBuiltinCode,
551 variable.storage());
552 (*varMap)[&variable] = std::make_unique<VariableReference>(offset, clonedVar.get());
553 auto result = std::make_unique<VarDeclaration>(clonedVar.get(),
John Stilesddcc8432021-01-15 15:32:32 -0500554 decl.baseType().clone(symbolTableForStatement),
555 decl.arraySize(),
John Stiles35fee4c2020-12-16 18:25:14 +0000556 std::move(initialValue));
Ethan Nicholas5b9b0db2021-01-21 13:12:01 -0500557 clonedVar->setDeclaration(result.get());
558 symbolTableForStatement->takeOwnershipOfSymbol(std::move(clonedVar));
559 return std::move(result);
John Stiles44e96be2020-08-31 13:16:04 -0400560 }
John Stiles44e96be2020-08-31 13:16:04 -0400561 default:
562 SkASSERT(false);
563 return nullptr;
564 }
565}
566
John Stiles7b920442020-12-17 10:43:41 -0500567Inliner::InlineVariable Inliner::makeInlineVariable(const String& baseName,
568 const Type* type,
569 SymbolTable* symbolTable,
570 Modifiers modifiers,
571 bool isBuiltinCode,
572 std::unique_ptr<Expression>* initialValue) {
573 // $floatLiteral or $intLiteral aren't real types that we can use for scratch variables, so
574 // replace them if they ever appear here. If this happens, we likely forgot to coerce a type
575 // somewhere during compilation.
John Stiles14975272021-01-12 11:41:14 -0500576 if (type->isLiteral()) {
577 SkDEBUGFAIL("found a $literal type while inlining");
578 type = &type->scalarTypeForLiteral();
John Stiles7b920442020-12-17 10:43:41 -0500579 }
580
581 // Provide our new variable with a unique name, and add it to our symbol table.
582 const String* namePtr = symbolTable->takeOwnershipOfString(
Ethan Nicholas6f4eee22021-01-11 12:37:42 -0500583 std::make_unique<String>(fMangler.uniqueName(baseName, symbolTable)));
John Stiles7b920442020-12-17 10:43:41 -0500584 StringFragment nameFrag{namePtr->c_str(), namePtr->length()};
585
586 // Create our new variable and add it to the symbol table.
587 InlineVariable result;
Ethan Nicholas5b9b0db2021-01-21 13:12:01 -0500588 auto var = std::make_unique<Variable>(/*offset=*/-1,
589 fModifiers->addToPool(Modifiers()),
590 nameFrag,
591 type,
592 isBuiltinCode,
593 Variable::Storage::kLocal);
John Stiles7b920442020-12-17 10:43:41 -0500594
595 // Prepare the variable declaration (taking extra care with `out` params to not clobber any
596 // initial value).
597 if (*initialValue && (modifiers.fFlags & Modifiers::kOut_Flag)) {
Ethan Nicholas5b9b0db2021-01-21 13:12:01 -0500598 result.fVarDecl = std::make_unique<VarDeclaration>(var.get(), type, /*arraySize=*/0,
John Stiles7b920442020-12-17 10:43:41 -0500599 (*initialValue)->clone());
600 } else {
Ethan Nicholas5b9b0db2021-01-21 13:12:01 -0500601 result.fVarDecl = std::make_unique<VarDeclaration>(var.get(), type, /*arraySize=*/0,
John Stiles7b920442020-12-17 10:43:41 -0500602 std::move(*initialValue));
603 }
Ethan Nicholas5b9b0db2021-01-21 13:12:01 -0500604 var->setDeclaration(&result.fVarDecl->as<VarDeclaration>());
605 result.fVarSymbol = symbolTable->add(std::move(var));
John Stiles7b920442020-12-17 10:43:41 -0500606 return result;
607}
608
John Stiles6eadf132020-09-08 10:16:10 -0400609Inliner::InlinedCall Inliner::inlineCall(FunctionCall* call,
John Stiles78047582020-12-16 16:17:41 -0500610 std::shared_ptr<SymbolTable> symbolTable,
Brian Osman3887a012020-09-30 13:22:27 -0400611 const FunctionDeclaration* caller) {
John Stiles44e96be2020-08-31 13:16:04 -0400612 // Inlining is more complicated here than in a typical compiler, because we have to have a
613 // high-level IR and can't just drop statements into the middle of an expression or even use
614 // gotos.
615 //
616 // Since we can't insert statements into an expression, we run the inline function as extra
617 // statements before the statement we're currently processing, relying on a lack of execution
618 // order guarantees. Since we can't use gotos (which are normally used to replace return
619 // statements), we wrap the whole function in a loop and use break statements to jump to the
620 // end.
John Stiles44e96be2020-08-31 13:16:04 -0400621 SkASSERT(fContext);
622 SkASSERT(call);
Ethan Nicholased84b732020-10-08 11:45:44 -0400623 SkASSERT(this->isSafeToInline(call->function().definition()));
John Stiles44e96be2020-08-31 13:16:04 -0400624
John Stiles8e3b6be2020-10-13 11:14:08 -0400625 ExpressionArray& arguments = call->arguments();
John Stiles6eadf132020-09-08 10:16:10 -0400626 const int offset = call->fOffset;
Ethan Nicholased84b732020-10-08 11:45:44 -0400627 const FunctionDefinition& function = *call->function().definition();
John Stiles77702f12020-12-17 14:38:56 -0500628 const ReturnComplexity returnComplexity = GetReturnComplexity(function);
629 bool hasEarlyReturn = (returnComplexity >= ReturnComplexity::kEarlyReturns);
John Stiles6eadf132020-09-08 10:16:10 -0400630
John Stiles44e96be2020-08-31 13:16:04 -0400631 InlinedCall inlinedCall;
John Stiles8f2a0cf2020-10-13 12:48:21 -0400632 inlinedCall.fInlinedBody = std::make_unique<Block>(offset, StatementArray{},
John Stiles6eadf132020-09-08 10:16:10 -0400633 /*symbols=*/nullptr,
634 /*isScope=*/false);
John Stiles98c1f822020-09-09 14:18:53 -0400635
Ethan Nicholas7bd60432020-09-25 14:31:59 -0400636 Block& inlinedBody = *inlinedCall.fInlinedBody;
John Stiles82f373c2020-10-20 13:58:05 -0400637 inlinedBody.children().reserve_back(
638 1 + // Inline marker
639 1 + // Result variable
640 arguments.size() + // Function arguments (passing in)
641 arguments.size() + // Function arguments (copy out-params back)
John Stiles7b920442020-12-17 10:43:41 -0500642 1); // Block for inlined code
John Stiles98c1f822020-09-09 14:18:53 -0400643
Ethan Nicholasceb62142020-10-09 16:51:18 -0400644 inlinedBody.children().push_back(std::make_unique<InlineMarker>(&call->function()));
John Stiles44e96be2020-08-31 13:16:04 -0400645
John Stilese41b4ee2020-09-28 12:28:16 -0400646 std::unique_ptr<Expression> resultExpr;
John Stiles511c5002021-02-25 11:17:02 -0500647 if (returnComplexity > ReturnComplexity::kSingleSafeReturn &&
648 function.declaration().returnType() != *fContext->fTypes.fVoid) {
649 // Create a variable to hold the result in the extra statements. We don't need to do this
650 // for void-return functions, or in cases that are simple enough that we can just replace
651 // the function-call node with the result expression.
John Stiles44e96be2020-08-31 13:16:04 -0400652 std::unique_ptr<Expression> noInitialValue;
John Stiles7b920442020-12-17 10:43:41 -0500653 InlineVariable var = this->makeInlineVariable(function.declaration().name(),
654 &function.declaration().returnType(),
655 symbolTable.get(), Modifiers{},
656 caller->isBuiltin(), &noInitialValue);
657 inlinedBody.children().push_back(std::move(var.fVarDecl));
658 resultExpr = std::make_unique<VariableReference>(/*offset=*/-1, var.fVarSymbol);
John Stiles511c5002021-02-25 11:17:02 -0500659 }
John Stiles44e96be2020-08-31 13:16:04 -0400660
661 // Create variables in the extra statements to hold the arguments, and assign the arguments to
662 // them.
663 VariableRewriteMap varMap;
John Stilese41b4ee2020-09-28 12:28:16 -0400664 std::vector<int> argsToCopyBack;
John Stiles44e96be2020-08-31 13:16:04 -0400665 for (int i = 0; i < (int) arguments.size(); ++i) {
Ethan Nicholas0a5d0962020-10-14 13:33:18 -0400666 const Variable* param = function.declaration().parameters()[i];
Ethan Nicholas041fd0a2020-10-07 16:42:04 -0400667 bool isOutParam = param->modifiers().fFlags & Modifiers::kOut_Flag;
John Stiles44e96be2020-08-31 13:16:04 -0400668
John Stiles44733aa2020-09-29 17:42:23 -0400669 // If this argument can be inlined trivially (e.g. a swizzle, or a constant array index)...
John Stilesc30fbca2020-11-19 16:25:49 -0500670 if (Analysis::IsTrivialExpression(*arguments[i])) {
John Stilese41b4ee2020-09-28 12:28:16 -0400671 // ... and it's an `out` param, or it isn't written to within the inline function...
Ethan Nicholas0a5d0962020-10-14 13:33:18 -0400672 if (isOutParam || !Analysis::StatementWritesToVariable(*function.body(), *param)) {
John Stilesf201af82020-09-29 16:57:55 -0400673 // ... we don't need to copy it at all! We can just use the existing expression.
674 varMap[param] = arguments[i]->clone();
John Stiles44e96be2020-08-31 13:16:04 -0400675 continue;
676 }
677 }
John Stilese41b4ee2020-09-28 12:28:16 -0400678 if (isOutParam) {
679 argsToCopyBack.push_back(i);
680 }
John Stiles7b920442020-12-17 10:43:41 -0500681 InlineVariable var = this->makeInlineVariable(param->name(), &arguments[i]->type(),
682 symbolTable.get(), param->modifiers(),
683 caller->isBuiltin(), &arguments[i]);
684 inlinedBody.children().push_back(std::move(var.fVarDecl));
685 varMap[param] = std::make_unique<VariableReference>(/*offset=*/-1, var.fVarSymbol);
John Stiles44e96be2020-08-31 13:16:04 -0400686 }
687
Ethan Nicholas0a5d0962020-10-14 13:33:18 -0400688 const Block& body = function.body()->as<Block>();
John Stiles7b920442020-12-17 10:43:41 -0500689 StatementArray* inlineStatements;
690
John Stiles44e96be2020-08-31 13:16:04 -0400691 if (hasEarlyReturn) {
692 // Since we output to backends that don't have a goto statement (which would normally be
John Stiles7b920442020-12-17 10:43:41 -0500693 // used to perform an early return), we fake it by wrapping the function in a single-
694 // iteration for loop, and use a continue statement to jump to the end of the loop
695 // prematurely.
696
697 // int _1_loop = 0;
698 symbolTable = std::make_shared<SymbolTable>(std::move(symbolTable), caller->isBuiltin());
John Stiles54e7c052021-01-11 14:22:36 -0500699 const Type* intType = fContext->fTypes.fInt.get();
John Stiles7b920442020-12-17 10:43:41 -0500700 std::unique_ptr<Expression> initialValue = std::make_unique<IntLiteral>(/*offset=*/-1,
701 /*value=*/0,
702 intType);
703 InlineVariable loopVar = this->makeInlineVariable("loop", intType, symbolTable.get(),
704 Modifiers{}, caller->isBuiltin(),
705 &initialValue);
706
707 // _1_loop < 1;
John Stilese2aec432021-03-01 09:27:48 -0500708 std::unique_ptr<Expression> test = BinaryExpression::Make(
709 *fContext,
John Stiles7b920442020-12-17 10:43:41 -0500710 std::make_unique<VariableReference>(/*offset=*/-1, loopVar.fVarSymbol),
711 Token::Kind::TK_LT,
John Stilese2aec432021-03-01 09:27:48 -0500712 std::make_unique<IntLiteral>(/*offset=*/-1, /*value=*/1, intType));
John Stiles7b920442020-12-17 10:43:41 -0500713
714 // _1_loop++
John Stiles52d3b012021-02-26 15:56:48 -0500715 std::unique_ptr<Expression> increment = PostfixExpression::Make(
716 *fContext,
John Stiles7b920442020-12-17 10:43:41 -0500717 std::make_unique<VariableReference>(/*offset=*/-1, loopVar.fVarSymbol,
718 VariableReference::RefKind::kReadWrite),
719 Token::Kind::TK_PLUSPLUS);
720
721 // {...}
722 auto innerBlock = std::make_unique<Block>(offset, StatementArray{},
723 /*symbols=*/nullptr, /*isScope=*/true);
724 inlineStatements = &innerBlock->children();
725
726 // for (int _1_loop = 0; _1_loop < 1; _1_loop++) {...}
John Stilesb321a072021-02-25 16:24:19 -0500727 inlinedBody.children().push_back(ForStatement::Make(*fContext, /*offset=*/-1,
728 std::move(loopVar.fVarDecl),
729 std::move(test),
730 std::move(increment),
731 std::move(innerBlock),
732 symbolTable));
John Stiles44e96be2020-08-31 13:16:04 -0400733 } else {
John Stilesfa9a0832020-12-17 10:43:58 -0500734 // No early returns, so we can just dump the code into our existing scopeless block.
735 inlineStatements = &inlinedBody.children();
John Stiles7b920442020-12-17 10:43:41 -0500736 }
737
738 inlineStatements->reserve_back(body.children().size() + argsToCopyBack.size());
739 for (const std::unique_ptr<Statement>& stmt : body.children()) {
740 inlineStatements->push_back(this->inlineStatement(offset, &varMap, symbolTable.get(),
John Stiles77702f12020-12-17 14:38:56 -0500741 &resultExpr, returnComplexity, *stmt,
John Stiles7b920442020-12-17 10:43:41 -0500742 caller->isBuiltin()));
John Stiles44e96be2020-08-31 13:16:04 -0400743 }
744
John Stilese41b4ee2020-09-28 12:28:16 -0400745 // Copy back the values of `out` parameters into their real destinations.
746 for (int i : argsToCopyBack) {
Ethan Nicholas0a5d0962020-10-14 13:33:18 -0400747 const Variable* p = function.declaration().parameters()[i];
John Stilese41b4ee2020-09-28 12:28:16 -0400748 SkASSERT(varMap.find(p) != varMap.end());
John Stiles3e5871c2021-02-25 20:52:03 -0500749 inlineStatements->push_back(ExpressionStatement::Make(
750 *fContext,
John Stilese2aec432021-03-01 09:27:48 -0500751 BinaryExpression::Make(*fContext,
752 clone_with_ref_kind(*arguments[i], VariableRefKind::kWrite),
753 Token::Kind::TK_EQ,
754 std::move(varMap[p]))));
John Stiles44e96be2020-08-31 13:16:04 -0400755 }
756
John Stiles0c2d14a2021-03-01 10:08:08 -0500757 if (resultExpr) {
758 // Return our result expression as-is.
John Stilese41b4ee2020-09-28 12:28:16 -0400759 inlinedCall.fReplacementExpr = std::move(resultExpr);
John Stiles0c2d14a2021-03-01 10:08:08 -0500760 } else if (function.declaration().returnType() == *fContext->fTypes.fVoid) {
John Stiles44e96be2020-08-31 13:16:04 -0400761 // It's a void function, so it doesn't actually result in anything, but we have to return
762 // something non-null as a standin.
Ethan Nicholas041fd0a2020-10-07 16:42:04 -0400763 inlinedCall.fReplacementExpr = std::make_unique<BoolLiteral>(*fContext,
764 offset,
John Stiles44e96be2020-08-31 13:16:04 -0400765 /*value=*/false);
John Stiles0c2d14a2021-03-01 10:08:08 -0500766 } else {
767 // It's a non-void function, but it never created a result expression--that is, it never
768 // returned anything! Discard our output and generate an error.
769 fContext->fErrors.error(function.fOffset, String("function '") +
770 function.declaration().name() +
771 "' exits without returning a value");
772 inlinedCall = {};
John Stiles44e96be2020-08-31 13:16:04 -0400773 }
774
John Stiles44e96be2020-08-31 13:16:04 -0400775 return inlinedCall;
776}
777
John Stiles2d7973a2020-10-02 15:01:03 -0400778bool Inliner::isSafeToInline(const FunctionDefinition* functionDef) {
John Stiles1c03d332020-10-13 10:30:23 -0400779 // A threshold of zero indicates that the inliner is completely disabled, so we can just return.
John Stilesd1204642021-02-17 16:30:02 -0500780 if (this->settings().fInlineThreshold <= 0) {
John Stiles1c03d332020-10-13 10:30:23 -0400781 return false;
782 }
783
John Stiles031a7672020-11-13 16:13:18 -0500784 // Enforce a limit on inlining to avoid pathological cases. (inliner/ExponentialGrowth.sksl)
785 if (fInlinedStatementCounter >= kInlinedStatementLimit) {
786 return false;
787 }
788
John Stiles2d7973a2020-10-02 15:01:03 -0400789 if (functionDef == nullptr) {
John Stiles44e96be2020-08-31 13:16:04 -0400790 // Can't inline something if we don't actually have its definition.
791 return false;
792 }
John Stiles2d7973a2020-10-02 15:01:03 -0400793
John Stiles74ebd7e2020-12-17 14:41:50 -0500794 // We don't have any mechanism to simulate early returns within a construct that supports
795 // continues (for/do/while), so we can't inline if there's a return inside one.
796 bool hasReturnInContinuableConstruct =
797 (count_returns_in_continuable_constructs(*functionDef) > 0);
798 return !hasReturnInContinuableConstruct;
John Stiles44e96be2020-08-31 13:16:04 -0400799}
800
John Stiles2d7973a2020-10-02 15:01:03 -0400801// A candidate function for inlining, containing everything that `inlineCall` needs.
802struct InlineCandidate {
John Stiles78047582020-12-16 16:17:41 -0500803 std::shared_ptr<SymbolTable> fSymbols; // the SymbolTable of the candidate
John Stiles2d7973a2020-10-02 15:01:03 -0400804 std::unique_ptr<Statement>* fParentStmt; // the parent Statement of the enclosing stmt
805 std::unique_ptr<Statement>* fEnclosingStmt; // the Statement containing the candidate
806 std::unique_ptr<Expression>* fCandidateExpr; // the candidate FunctionCall to be inlined
807 FunctionDefinition* fEnclosingFunction; // the Function containing the candidate
John Stiles2d7973a2020-10-02 15:01:03 -0400808};
John Stiles93442622020-09-11 12:11:27 -0400809
John Stiles2d7973a2020-10-02 15:01:03 -0400810struct InlineCandidateList {
811 std::vector<InlineCandidate> fCandidates;
812};
813
814class InlineCandidateAnalyzer {
John Stiles70957c82020-10-02 16:42:10 -0400815public:
816 // A list of all the inlining candidates we found during analysis.
817 InlineCandidateList* fCandidateList;
John Stiles2d7973a2020-10-02 15:01:03 -0400818
John Stiles70957c82020-10-02 16:42:10 -0400819 // A stack of the symbol tables; since most nodes don't have one, expected to be shallower than
820 // the enclosing-statement stack.
John Stiles78047582020-12-16 16:17:41 -0500821 std::vector<std::shared_ptr<SymbolTable>> fSymbolTableStack;
John Stiles70957c82020-10-02 16:42:10 -0400822 // A stack of "enclosing" statements--these would be suitable for the inliner to use for adding
823 // new instructions. Not all statements are suitable (e.g. a for-loop's initializer). The
824 // inliner might replace a statement with a block containing the statement.
825 std::vector<std::unique_ptr<Statement>*> fEnclosingStmtStack;
826 // The function that we're currently processing (i.e. inlining into).
827 FunctionDefinition* fEnclosingFunction = nullptr;
John Stiles93442622020-09-11 12:11:27 -0400828
Brian Osman0006ad02020-11-18 15:38:39 -0500829 void visit(const std::vector<std::unique_ptr<ProgramElement>>& elements,
John Stiles78047582020-12-16 16:17:41 -0500830 std::shared_ptr<SymbolTable> symbols,
Brian Osman0006ad02020-11-18 15:38:39 -0500831 InlineCandidateList* candidateList) {
John Stiles70957c82020-10-02 16:42:10 -0400832 fCandidateList = candidateList;
Brian Osman0006ad02020-11-18 15:38:39 -0500833 fSymbolTableStack.push_back(symbols);
John Stiles93442622020-09-11 12:11:27 -0400834
Brian Osman0006ad02020-11-18 15:38:39 -0500835 for (const std::unique_ptr<ProgramElement>& pe : elements) {
Brian Osman1179fcf2020-10-08 16:04:40 -0400836 this->visitProgramElement(pe.get());
John Stiles93442622020-09-11 12:11:27 -0400837 }
838
John Stiles70957c82020-10-02 16:42:10 -0400839 fSymbolTableStack.pop_back();
840 fCandidateList = nullptr;
841 }
842
843 void visitProgramElement(ProgramElement* pe) {
844 switch (pe->kind()) {
845 case ProgramElement::Kind::kFunction: {
846 FunctionDefinition& funcDef = pe->as<FunctionDefinition>();
Brian Osman0006ad02020-11-18 15:38:39 -0500847 fEnclosingFunction = &funcDef;
848 this->visitStatement(&funcDef.body());
John Stiles70957c82020-10-02 16:42:10 -0400849 break;
John Stiles93442622020-09-11 12:11:27 -0400850 }
John Stiles70957c82020-10-02 16:42:10 -0400851 default:
852 // The inliner can't operate outside of a function's scope.
853 break;
854 }
855 }
856
857 void visitStatement(std::unique_ptr<Statement>* stmt,
858 bool isViableAsEnclosingStatement = true) {
859 if (!*stmt) {
860 return;
John Stiles93442622020-09-11 12:11:27 -0400861 }
862
John Stiles70957c82020-10-02 16:42:10 -0400863 size_t oldEnclosingStmtStackSize = fEnclosingStmtStack.size();
864 size_t oldSymbolStackSize = fSymbolTableStack.size();
John Stiles93442622020-09-11 12:11:27 -0400865
John Stiles70957c82020-10-02 16:42:10 -0400866 if (isViableAsEnclosingStatement) {
867 fEnclosingStmtStack.push_back(stmt);
John Stiles93442622020-09-11 12:11:27 -0400868 }
869
John Stiles70957c82020-10-02 16:42:10 -0400870 switch ((*stmt)->kind()) {
871 case Statement::Kind::kBreak:
872 case Statement::Kind::kContinue:
873 case Statement::Kind::kDiscard:
874 case Statement::Kind::kInlineMarker:
875 case Statement::Kind::kNop:
876 break;
877
878 case Statement::Kind::kBlock: {
879 Block& block = (*stmt)->as<Block>();
880 if (block.symbolTable()) {
John Stiles78047582020-12-16 16:17:41 -0500881 fSymbolTableStack.push_back(block.symbolTable());
John Stiles70957c82020-10-02 16:42:10 -0400882 }
883
884 for (std::unique_ptr<Statement>& stmt : block.children()) {
885 this->visitStatement(&stmt);
886 }
887 break;
John Stiles93442622020-09-11 12:11:27 -0400888 }
John Stiles70957c82020-10-02 16:42:10 -0400889 case Statement::Kind::kDo: {
890 DoStatement& doStmt = (*stmt)->as<DoStatement>();
891 // The loop body is a candidate for inlining.
892 this->visitStatement(&doStmt.statement());
893 // The inliner isn't smart enough to inline the test-expression for a do-while
894 // loop at this time. There are two limitations:
895 // - We would need to insert the inlined-body block at the very end of the do-
896 // statement's inner fStatement. We don't support that today, but it's doable.
897 // - We cannot inline the test expression if the loop uses `continue` anywhere; that
898 // would skip over the inlined block that evaluates the test expression. There
899 // isn't a good fix for this--any workaround would be more complex than the cost
900 // of a function call. However, loops that don't use `continue` would still be
901 // viable candidates for inlining.
902 break;
John Stiles93442622020-09-11 12:11:27 -0400903 }
John Stiles70957c82020-10-02 16:42:10 -0400904 case Statement::Kind::kExpression: {
905 ExpressionStatement& expr = (*stmt)->as<ExpressionStatement>();
906 this->visitExpression(&expr.expression());
907 break;
908 }
909 case Statement::Kind::kFor: {
910 ForStatement& forStmt = (*stmt)->as<ForStatement>();
Ethan Nicholas0d31ed52020-10-05 14:47:09 -0400911 if (forStmt.symbols()) {
John Stiles78047582020-12-16 16:17:41 -0500912 fSymbolTableStack.push_back(forStmt.symbols());
John Stiles70957c82020-10-02 16:42:10 -0400913 }
914
915 // The initializer and loop body are candidates for inlining.
Ethan Nicholas0d31ed52020-10-05 14:47:09 -0400916 this->visitStatement(&forStmt.initializer(),
John Stiles70957c82020-10-02 16:42:10 -0400917 /*isViableAsEnclosingStatement=*/false);
Ethan Nicholas0d31ed52020-10-05 14:47:09 -0400918 this->visitStatement(&forStmt.statement());
John Stiles70957c82020-10-02 16:42:10 -0400919
920 // The inliner isn't smart enough to inline the test- or increment-expressions
921 // of a for loop loop at this time. There are a handful of limitations:
922 // - We would need to insert the test-expression block at the very beginning of the
923 // for-loop's inner fStatement, and the increment-expression block at the very
924 // end. We don't support that today, but it's doable.
925 // - The for-loop's built-in test-expression would need to be dropped entirely,
926 // and the loop would be halted via a break statement at the end of the inlined
927 // test-expression. This is again something we don't support today, but it could
928 // be implemented.
929 // - We cannot inline the increment-expression if the loop uses `continue` anywhere;
930 // that would skip over the inlined block that evaluates the increment expression.
931 // There isn't a good fix for this--any workaround would be more complex than the
932 // cost of a function call. However, loops that don't use `continue` would still
933 // be viable candidates for increment-expression inlining.
934 break;
935 }
936 case Statement::Kind::kIf: {
937 IfStatement& ifStmt = (*stmt)->as<IfStatement>();
Ethan Nicholas8c44eca2020-10-07 16:47:09 -0400938 this->visitExpression(&ifStmt.test());
939 this->visitStatement(&ifStmt.ifTrue());
940 this->visitStatement(&ifStmt.ifFalse());
John Stiles70957c82020-10-02 16:42:10 -0400941 break;
942 }
943 case Statement::Kind::kReturn: {
944 ReturnStatement& returnStmt = (*stmt)->as<ReturnStatement>();
Ethan Nicholas2a4952d2020-10-08 15:35:56 -0400945 this->visitExpression(&returnStmt.expression());
John Stiles70957c82020-10-02 16:42:10 -0400946 break;
947 }
948 case Statement::Kind::kSwitch: {
949 SwitchStatement& switchStmt = (*stmt)->as<SwitchStatement>();
Ethan Nicholas01b05e52020-10-22 15:53:41 -0400950 if (switchStmt.symbols()) {
John Stiles78047582020-12-16 16:17:41 -0500951 fSymbolTableStack.push_back(switchStmt.symbols());
John Stiles70957c82020-10-02 16:42:10 -0400952 }
953
Ethan Nicholas01b05e52020-10-22 15:53:41 -0400954 this->visitExpression(&switchStmt.value());
John Stiles2d4f9592020-10-30 10:29:12 -0400955 for (const std::unique_ptr<SwitchCase>& switchCase : switchStmt.cases()) {
John Stiles70957c82020-10-02 16:42:10 -0400956 // The switch-case's fValue cannot be a FunctionCall; skip it.
John Stiles2d4f9592020-10-30 10:29:12 -0400957 for (std::unique_ptr<Statement>& caseBlock : switchCase->statements()) {
John Stiles70957c82020-10-02 16:42:10 -0400958 this->visitStatement(&caseBlock);
959 }
960 }
961 break;
962 }
963 case Statement::Kind::kVarDeclaration: {
964 VarDeclaration& varDeclStmt = (*stmt)->as<VarDeclaration>();
965 // Don't need to scan the declaration's sizes; those are always IntLiterals.
Ethan Nicholasc51f33e2020-10-13 13:49:44 -0400966 this->visitExpression(&varDeclStmt.value());
John Stiles70957c82020-10-02 16:42:10 -0400967 break;
968 }
John Stiles70957c82020-10-02 16:42:10 -0400969 default:
970 SkUNREACHABLE;
John Stiles93442622020-09-11 12:11:27 -0400971 }
972
John Stiles70957c82020-10-02 16:42:10 -0400973 // Pop our symbol and enclosing-statement stacks.
974 fSymbolTableStack.resize(oldSymbolStackSize);
975 fEnclosingStmtStack.resize(oldEnclosingStmtStackSize);
976 }
977
978 void visitExpression(std::unique_ptr<Expression>* expr) {
979 if (!*expr) {
980 return;
John Stiles93442622020-09-11 12:11:27 -0400981 }
John Stiles70957c82020-10-02 16:42:10 -0400982
983 switch ((*expr)->kind()) {
984 case Expression::Kind::kBoolLiteral:
985 case Expression::Kind::kDefined:
Brian Osmanbe0b3b72021-01-06 14:27:35 -0500986 case Expression::Kind::kExternalFunctionReference:
John Stiles70957c82020-10-02 16:42:10 -0400987 case Expression::Kind::kFieldAccess:
988 case Expression::Kind::kFloatLiteral:
989 case Expression::Kind::kFunctionReference:
990 case Expression::Kind::kIntLiteral:
John Stiles70957c82020-10-02 16:42:10 -0400991 case Expression::Kind::kSetting:
992 case Expression::Kind::kTypeReference:
993 case Expression::Kind::kVariableReference:
994 // Nothing to scan here.
995 break;
996
997 case Expression::Kind::kBinary: {
998 BinaryExpression& binaryExpr = (*expr)->as<BinaryExpression>();
John Stiles2d4f9592020-10-30 10:29:12 -0400999 this->visitExpression(&binaryExpr.left());
John Stiles70957c82020-10-02 16:42:10 -04001000
1001 // Logical-and and logical-or binary expressions do not inline the right side,
1002 // because that would invalidate short-circuiting. That is, when evaluating
1003 // expressions like these:
1004 // (false && x()) // always false
1005 // (true || y()) // always true
1006 // It is illegal for side-effects from x() or y() to occur. The simplest way to
1007 // enforce that rule is to avoid inlining the right side entirely. However, it is
1008 // safe for other types of binary expression to inline both sides.
John Stiles45990502021-02-16 10:55:27 -05001009 Operator op = binaryExpr.getOperator();
1010 bool shortCircuitable = (op.kind() == Token::Kind::TK_LOGICALAND ||
1011 op.kind() == Token::Kind::TK_LOGICALOR);
John Stiles70957c82020-10-02 16:42:10 -04001012 if (!shortCircuitable) {
John Stiles2d4f9592020-10-30 10:29:12 -04001013 this->visitExpression(&binaryExpr.right());
John Stiles70957c82020-10-02 16:42:10 -04001014 }
1015 break;
1016 }
1017 case Expression::Kind::kConstructor: {
1018 Constructor& constructorExpr = (*expr)->as<Constructor>();
1019 for (std::unique_ptr<Expression>& arg : constructorExpr.arguments()) {
1020 this->visitExpression(&arg);
1021 }
1022 break;
1023 }
1024 case Expression::Kind::kExternalFunctionCall: {
1025 ExternalFunctionCall& funcCallExpr = (*expr)->as<ExternalFunctionCall>();
1026 for (std::unique_ptr<Expression>& arg : funcCallExpr.arguments()) {
1027 this->visitExpression(&arg);
1028 }
1029 break;
1030 }
1031 case Expression::Kind::kFunctionCall: {
1032 FunctionCall& funcCallExpr = (*expr)->as<FunctionCall>();
Ethan Nicholas0dec9922020-10-05 15:51:52 -04001033 for (std::unique_ptr<Expression>& arg : funcCallExpr.arguments()) {
John Stiles70957c82020-10-02 16:42:10 -04001034 this->visitExpression(&arg);
1035 }
1036 this->addInlineCandidate(expr);
1037 break;
1038 }
1039 case Expression::Kind::kIndex:{
1040 IndexExpression& indexExpr = (*expr)->as<IndexExpression>();
Ethan Nicholas2a4952d2020-10-08 15:35:56 -04001041 this->visitExpression(&indexExpr.base());
1042 this->visitExpression(&indexExpr.index());
John Stiles70957c82020-10-02 16:42:10 -04001043 break;
1044 }
1045 case Expression::Kind::kPostfix: {
1046 PostfixExpression& postfixExpr = (*expr)->as<PostfixExpression>();
Ethan Nicholas444ccc62020-10-09 10:16:22 -04001047 this->visitExpression(&postfixExpr.operand());
John Stiles70957c82020-10-02 16:42:10 -04001048 break;
1049 }
1050 case Expression::Kind::kPrefix: {
1051 PrefixExpression& prefixExpr = (*expr)->as<PrefixExpression>();
Ethan Nicholas444ccc62020-10-09 10:16:22 -04001052 this->visitExpression(&prefixExpr.operand());
John Stiles70957c82020-10-02 16:42:10 -04001053 break;
1054 }
1055 case Expression::Kind::kSwizzle: {
1056 Swizzle& swizzleExpr = (*expr)->as<Swizzle>();
Ethan Nicholas6b4d5812020-10-12 16:11:51 -04001057 this->visitExpression(&swizzleExpr.base());
John Stiles70957c82020-10-02 16:42:10 -04001058 break;
1059 }
1060 case Expression::Kind::kTernary: {
1061 TernaryExpression& ternaryExpr = (*expr)->as<TernaryExpression>();
1062 // The test expression is a candidate for inlining.
Ethan Nicholasdd218162020-10-08 05:48:01 -04001063 this->visitExpression(&ternaryExpr.test());
John Stiles70957c82020-10-02 16:42:10 -04001064 // The true- and false-expressions cannot be inlined, because we are only allowed to
1065 // evaluate one side.
1066 break;
1067 }
1068 default:
1069 SkUNREACHABLE;
1070 }
1071 }
1072
1073 void addInlineCandidate(std::unique_ptr<Expression>* candidate) {
1074 fCandidateList->fCandidates.push_back(
1075 InlineCandidate{fSymbolTableStack.back(),
1076 find_parent_statement(fEnclosingStmtStack),
1077 fEnclosingStmtStack.back(),
1078 candidate,
John Stiles9b9415e2020-11-23 14:48:06 -05001079 fEnclosingFunction});
John Stiles70957c82020-10-02 16:42:10 -04001080 }
John Stiles2d7973a2020-10-02 15:01:03 -04001081};
John Stiles93442622020-09-11 12:11:27 -04001082
John Stiles9b9415e2020-11-23 14:48:06 -05001083static const FunctionDeclaration& candidate_func(const InlineCandidate& candidate) {
1084 return (*candidate.fCandidateExpr)->as<FunctionCall>().function();
1085}
John Stiles915a38c2020-09-14 09:38:13 -04001086
John Stiles9b9415e2020-11-23 14:48:06 -05001087bool Inliner::candidateCanBeInlined(const InlineCandidate& candidate, InlinabilityCache* cache) {
1088 const FunctionDeclaration& funcDecl = candidate_func(candidate);
John Stiles1c03d332020-10-13 10:30:23 -04001089 auto [iter, wasInserted] = cache->insert({&funcDecl, false});
John Stiles2d7973a2020-10-02 15:01:03 -04001090 if (wasInserted) {
1091 // Recursion is forbidden here to avoid an infinite death spiral of inlining.
John Stiles1c03d332020-10-13 10:30:23 -04001092 iter->second = this->isSafeToInline(funcDecl.definition()) &&
1093 !contains_recursive_call(funcDecl);
John Stiles93442622020-09-11 12:11:27 -04001094 }
1095
John Stiles2d7973a2020-10-02 15:01:03 -04001096 return iter->second;
1097}
1098
John Stiles9b9415e2020-11-23 14:48:06 -05001099int Inliner::getFunctionSize(const FunctionDeclaration& funcDecl, FunctionSizeCache* cache) {
1100 auto [iter, wasInserted] = cache->insert({&funcDecl, 0});
John Stiles2d7973a2020-10-02 15:01:03 -04001101 if (wasInserted) {
John Stiles9b9415e2020-11-23 14:48:06 -05001102 iter->second = Analysis::NodeCountUpToLimit(*funcDecl.definition(),
John Stilesd1204642021-02-17 16:30:02 -05001103 this->settings().fInlineThreshold);
John Stiles2d7973a2020-10-02 15:01:03 -04001104 }
John Stiles2d7973a2020-10-02 15:01:03 -04001105 return iter->second;
1106}
1107
Brian Osman0006ad02020-11-18 15:38:39 -05001108void Inliner::buildCandidateList(const std::vector<std::unique_ptr<ProgramElement>>& elements,
John Stiles78047582020-12-16 16:17:41 -05001109 std::shared_ptr<SymbolTable> symbols, ProgramUsage* usage,
Brian Osman0006ad02020-11-18 15:38:39 -05001110 InlineCandidateList* candidateList) {
John Stiles2d7973a2020-10-02 15:01:03 -04001111 // This is structured much like a ProgramVisitor, but does not actually use ProgramVisitor.
1112 // The analyzer needs to keep track of the `unique_ptr<T>*` of statements and expressions so
1113 // that they can later be replaced, and ProgramVisitor does not provide this; it only provides a
1114 // `const T&`.
1115 InlineCandidateAnalyzer analyzer;
Brian Osman0006ad02020-11-18 15:38:39 -05001116 analyzer.visit(elements, symbols, candidateList);
John Stiles2d7973a2020-10-02 15:01:03 -04001117
John Stiles0ad233f2020-11-25 11:02:05 -05001118 // Early out if there are no inlining candidates.
John Stiles2d7973a2020-10-02 15:01:03 -04001119 std::vector<InlineCandidate>& candidates = candidateList->fCandidates;
John Stiles0ad233f2020-11-25 11:02:05 -05001120 if (candidates.empty()) {
1121 return;
1122 }
1123
1124 // Remove candidates that are not safe to inline.
John Stiles2d7973a2020-10-02 15:01:03 -04001125 InlinabilityCache cache;
1126 candidates.erase(std::remove_if(candidates.begin(),
1127 candidates.end(),
1128 [&](const InlineCandidate& candidate) {
1129 return !this->candidateCanBeInlined(candidate, &cache);
1130 }),
1131 candidates.end());
1132
John Stiles0ad233f2020-11-25 11:02:05 -05001133 // If the inline threshold is unlimited, or if we have no candidates left, our candidate list is
1134 // complete.
John Stilesd1204642021-02-17 16:30:02 -05001135 if (this->settings().fInlineThreshold == INT_MAX || candidates.empty()) {
John Stiles0ad233f2020-11-25 11:02:05 -05001136 return;
John Stiles2d7973a2020-10-02 15:01:03 -04001137 }
John Stiles0ad233f2020-11-25 11:02:05 -05001138
1139 // Remove candidates on a per-function basis if the effect of inlining would be to make more
1140 // than `inlineThreshold` nodes. (i.e. if Func() would be inlined six times and its size is
1141 // 10 nodes, it should be inlined if the inlineThreshold is 60 or higher.)
1142 FunctionSizeCache functionSizeCache;
1143 FunctionSizeCache candidateTotalCost;
1144 for (InlineCandidate& candidate : candidates) {
1145 const FunctionDeclaration& fnDecl = candidate_func(candidate);
1146 candidateTotalCost[&fnDecl] += this->getFunctionSize(fnDecl, &functionSizeCache);
1147 }
1148
John Stilesd1204642021-02-17 16:30:02 -05001149 candidates.erase(std::remove_if(candidates.begin(), candidates.end(),
1150 [&](const InlineCandidate& candidate) {
1151 const FunctionDeclaration& fnDecl = candidate_func(candidate);
1152 if (fnDecl.modifiers().fFlags & Modifiers::kInline_Flag) {
1153 // Functions marked `inline` ignore size limitations.
1154 return false;
1155 }
1156 if (usage->get(fnDecl) == 1) {
1157 // If a function is only used once, it's cost-free to inline.
1158 return false;
1159 }
1160 if (candidateTotalCost[&fnDecl] <= this->settings().fInlineThreshold) {
1161 // We won't exceed the inline threshold by inlining this.
1162 return false;
1163 }
1164 // Inlining this function will add too many IRNodes.
1165 return true;
1166 }),
1167 candidates.end());
John Stiles2d7973a2020-10-02 15:01:03 -04001168}
1169
Brian Osman0006ad02020-11-18 15:38:39 -05001170bool Inliner::analyze(const std::vector<std::unique_ptr<ProgramElement>>& elements,
John Stiles78047582020-12-16 16:17:41 -05001171 std::shared_ptr<SymbolTable> symbols,
Brian Osman0006ad02020-11-18 15:38:39 -05001172 ProgramUsage* usage) {
John Stilesd34d56e2020-10-12 12:04:47 -04001173 // A threshold of zero indicates that the inliner is completely disabled, so we can just return.
John Stilesd1204642021-02-17 16:30:02 -05001174 if (this->settings().fInlineThreshold <= 0) {
John Stilesd34d56e2020-10-12 12:04:47 -04001175 return false;
1176 }
1177
John Stiles031a7672020-11-13 16:13:18 -05001178 // Enforce a limit on inlining to avoid pathological cases. (inliner/ExponentialGrowth.sksl)
1179 if (fInlinedStatementCounter >= kInlinedStatementLimit) {
1180 return false;
1181 }
1182
John Stiles2d7973a2020-10-02 15:01:03 -04001183 InlineCandidateList candidateList;
John Stiles9b9415e2020-11-23 14:48:06 -05001184 this->buildCandidateList(elements, symbols, usage, &candidateList);
John Stiles2d7973a2020-10-02 15:01:03 -04001185
John Stiles915a38c2020-09-14 09:38:13 -04001186 // Inline the candidates where we've determined that it's safe to do so.
1187 std::unordered_set<const std::unique_ptr<Statement>*> enclosingStmtSet;
1188 bool madeChanges = false;
John Stiles2d7973a2020-10-02 15:01:03 -04001189 for (const InlineCandidate& candidate : candidateList.fCandidates) {
John Stiles915a38c2020-09-14 09:38:13 -04001190 FunctionCall& funcCall = (*candidate.fCandidateExpr)->as<FunctionCall>();
John Stiles915a38c2020-09-14 09:38:13 -04001191
1192 // Inlining two expressions using the same enclosing statement in the same inlining pass
1193 // does not work properly. If this happens, skip it; we'll get it in the next pass.
1194 auto [unusedIter, inserted] = enclosingStmtSet.insert(candidate.fEnclosingStmt);
1195 if (!inserted) {
1196 continue;
1197 }
1198
1199 // Convert the function call to its inlined equivalent.
Brian Osman3887a012020-09-30 13:22:27 -04001200 InlinedCall inlinedCall = this->inlineCall(&funcCall, candidate.fSymbols,
Ethan Nicholas0a5d0962020-10-14 13:33:18 -04001201 &candidate.fEnclosingFunction->declaration());
John Stiles915a38c2020-09-14 09:38:13 -04001202
John Stiles0c2d14a2021-03-01 10:08:08 -05001203 // Stop if an error was detected during the inlining process.
1204 if (!inlinedCall.fInlinedBody && !inlinedCall.fReplacementExpr) {
1205 break;
John Stiles915a38c2020-09-14 09:38:13 -04001206 }
1207
John Stiles0c2d14a2021-03-01 10:08:08 -05001208 // Ensure that the inlined body has a scope if it needs one.
1209 this->ensureScopedBlocks(inlinedCall.fInlinedBody.get(), candidate.fParentStmt->get());
1210
1211 // Add references within the inlined body
1212 usage->add(inlinedCall.fInlinedBody.get());
1213
1214 // Move the enclosing statement to the end of the unscoped Block containing the inlined
1215 // function, then replace the enclosing statement with that Block.
1216 // Before:
1217 // fInlinedBody = Block{ stmt1, stmt2, stmt3 }
1218 // fEnclosingStmt = stmt4
1219 // After:
1220 // fInlinedBody = null
1221 // fEnclosingStmt = Block{ stmt1, stmt2, stmt3, stmt4 }
1222 inlinedCall.fInlinedBody->children().push_back(std::move(*candidate.fEnclosingStmt));
1223 *candidate.fEnclosingStmt = std::move(inlinedCall.fInlinedBody);
1224
John Stiles915a38c2020-09-14 09:38:13 -04001225 // Replace the candidate function call with our replacement expression.
Brian Osman010ce6a2020-10-19 16:34:10 -04001226 usage->replace(candidate.fCandidateExpr->get(), inlinedCall.fReplacementExpr.get());
John Stiles915a38c2020-09-14 09:38:13 -04001227 *candidate.fCandidateExpr = std::move(inlinedCall.fReplacementExpr);
1228 madeChanges = true;
1229
John Stiles031a7672020-11-13 16:13:18 -05001230 // Stop inlining if we've reached our hard cap on new statements.
1231 if (fInlinedStatementCounter >= kInlinedStatementLimit) {
1232 break;
1233 }
1234
John Stiles915a38c2020-09-14 09:38:13 -04001235 // Note that nothing was destroyed except for the FunctionCall. All other nodes should
1236 // remain valid.
1237 }
1238
1239 return madeChanges;
John Stiles93442622020-09-11 12:11:27 -04001240}
1241
John Stiles44e96be2020-08-31 13:16:04 -04001242} // namespace SkSL