Dotty Documentation


class Inliner
extends Object

Produces an inlined version of call via its inlined method.

[-] Constructors

Inliner ( call: Tree , rhs: Tree )
Inliner ( implicit ctx: Context )

[-] Members

[+] private object InlineTyper

A typer for inlined code. Its purpose is: 1. Implement constant folding over inlined code 2. Selectively expand ifs with constant conditions 3. Inline arguments that are inlineable closures 4. Make sure inlined code is type-correct. 5. Make sure that the tree's typing is idempotent (so that future -Ycheck passes succeed)

[+] private object InlineableClosure

An extractor for references to closure arguments that refer to @inline methods

[+] private val argss : List [ List [ Tree ] ]
[+] val bindingsBuf : ListBuffer [ ValOrDefDef ]

A buffer for bindings that define proxies for actual arguments

[+] private val call : Tree
[+] private implicit val ctx : Context
[+] private val meth : Symbol
[+] private val methPart : Tree [ Type ]
[+] private val paramBinding : HashMap [ Name, Type ]

A map from parameter names of the inline method to references of the actual arguments. For a type argument this is the full argument type. For a value argument, it is a reference to either the argument value (if the argument is a pure expression of singleton type), or to val or def acting as a proxy (if the argument is something else).

[+] private val paramProxy : HashMap [ Type, Type ]

A map from references to (type and value) parameters of the inline method to their corresponding argument or proxy references, as given by paramBinding.

[+] private val prefix : Tree [ Type ]
[+] private val rhs : Tree
[+] private val targs : List [ Tree ]
[+] private val thisProxy : HashMap [ ClassSymbol, TermRef ]

A map from the classes of (direct and outer) this references in rhs to references of their proxies. Note that we can't index by the ThisType itself since there are several possible forms to express what is logicaly the same ThisType. E.g.

ThisType(TypeRef(ThisType(p), cls))


ThisType(TypeRef(TermRef(ThisType(), p), cls))

These are different (wrt ==) types but represent logically the same key

[+] private def canElideThis ( tpe: ThisType ) : Boolean
[+] private def computeParamBindings ( tp: Type , targs: List [ Tree ] , argss: List [ List [ Tree ] ] ) : Unit

Populate paramBinding and bindingsBuf by matching parameters with corresponding arguments. bindingbuf will be further extended later by proxies to this-references.

[+] def inlined ( pt: Type ) : Inlined [ Type ]

The Inlined node representing the inlined call

[+] private def newSym ( name: Name , flags: FlagSet , info: Type ) : Symbol
[+] private def registerLeaf ( tree: Tree ) : Unit

Register type of leaf node

[+] private def registerType ( tpe: Type ) : Unit

Populate thisProxy and paramProxy as follows:

1a. If given type refers to a static this, thisProxy binds it to corresponding global reference, 1b. If given type refers to an instance this, create a proxy symbol and bind the thistype to refer to the proxy. The proxy is not yet entered in bindingsBuf that will come later. 2. If given type refers to a parameter, make paramProxy refer to the entry stored in paramNames under the parameter's name. This roundabout way to bind parameter references to proxies is done because we not known a priori what the parameter references of a method are (we only know the method's type, but that contains TypeParamRefs and MethodParams, not TypeRefs or TermRefs.