dotty.tools.dotc.typer

Type members

Classlikes

object Applications
Companion
class
Companion
object
object Checking
Companion
class
trait Checking
Companion
object
object ConstFold
trait Deriving

A typer mixin that implements type class derivation functionality

A typer mixin that implements type class derivation functionality

object Docstrings
object Dynamic
Companion
class
trait Dynamic

Handles programmable member selections of Dynamic instances and values with structural types. Two functionalities:

Handles programmable member selections of Dynamic instances and values with structural types. Two functionalities:

  1. Translates selection that does not typecheck according to the scala.Dynamic rules: foo.bar(baz) = quux ~~> foo.selectDynamic(bar).update(baz, quux) foo.bar = baz ~~> foo.updateDynamic("bar")(baz) foo.bar(x = bazX, y = bazY, baz, ...) ~~> foo.applyDynamicNamed("bar")(("x", bazX), ("y", bazY), ("", baz), ...) foo.bar(baz0, baz1, ...) ~~> foo.applyDynamic(bar)(baz0, baz1, ...) foo.bar ~~> foo.selectDynamic(bar)

The first matching rule of is applied.

  1. Translates member selections on structural types to calls of selectDynamic or applyDynamic on a Selectable instance. @See handleStructural.
Companion
object
object EtaExpansion extends LiftImpure

Lifter for eta expansion

Lifter for eta expansion

object ForceDegree

An enumeration controlling the degree of forcing in "is-dully-defined" checks.

An enumeration controlling the degree of forcing in "is-dully-defined" checks.

class FrontEnd extends Phase
Companion
object
object FrontEnd
Companion
class
enum IfBottom

Info relating to implicits that is kept for one run

Info relating to implicits that is kept for one run

class ImplicitSearchError(arg: Tree, pt: Type, where: String, paramSymWithMethodCallTree: Option[(Symbol, Tree)], ignoredInstanceNormalImport: => Option[SearchSuccess], importSuggestionAddendum: => String)(using ctx: Context)
object Implicits

Implicit resolution

Implicit resolution

Companion
class
trait Implicits

The implicit resolution part of type checking

The implicit resolution part of type checking

Companion
object
object ImportInfo
Companion
class
class ImportInfo(symf: Context => Symbol, val selectors: List[ImportSelector], val qualifier: Tree, val isRootImport: Boolean) extends Showable

Info relating to an import clause

Info relating to an import clause

Value Params
isRootImport

true if this is one of the implicit imports of scala, java.lang, scala.Predef in the start context, false otherwise.

qualifier

The import qualifier, or EmptyTree for root imports. Defined for all explicit imports from ident or select nodes.

selectors

The selector clauses

symf

A function that computes the import symbol defined by the clause

Companion
object

This trait defines the method importSuggestionAddendum that adds an addendum to error messages suggesting additional imports.

This trait defines the method importSuggestionAddendum that adds an addendum to error messages suggesting additional imports.

object Inferencing
Companion
class
Companion
object
object Inliner
Companion
class
class Inliner(call: Tree, rhsToInline: Tree)(using `x$3`: Context)

Produces an inlined version of call via its inlined method.

Produces an inlined version of call via its inlined method.

Value Params
call

the original call to an inlineable method

rhsToInline

the body of the inlineable method that replaces the call.

Companion
object
object JavaChecks

PostTyper doesn't run on java sources, but some checks still need to be applied.

PostTyper doesn't run on java sources, but some checks still need to be applied.

class LiftComplex extends Lifter

Lift all impure or complex arguments

Lift all impure or complex arguments

Companion
object
object LiftComplex extends LiftComplex
Companion
class
object LiftErased extends LiftComplex
class LiftImpure extends Lifter

Lift all impure arguments

Lift all impure arguments

Companion
object
object LiftImpure extends LiftImpure
Companion
class
object LiftToDefs extends LiftComplex

Lift all impure or complex arguments to defs

Lift all impure or complex arguments to defs

abstract class Lifter

A class that handles argument lifting. Argument lifting is needed in the following scenarios:

A class that handles argument lifting. Argument lifting is needed in the following scenarios:

  • eta expansion
  • applications with default arguments
  • applications with out-of-order named arguments Lifting generally lifts impure expressions only, except in the case of possible default arguments, where we lift also complex pure expressions, since in that case arguments can be duplicated as arguments to default argument methods.
class Namer

This class creates symbols from definitions and imports and gives them lazy types.

This class creates symbols from definitions and imports and gives them lazy types.

Timeline:

During enter, trees are expanded as necessary, populating the expandedTree map. Symbols are created, and the symOfTree map is set up.

Symbol completion causes some trees to be already typechecked and typedTree entries are created to associate the typed trees with the untyped expanded originals.

During typer, original trees are first expanded using expandedTree. For each expanded member definition or import we extract and remove the corresponding symbol from the symOfTree map and complete it. We then consult the typedTree map to see whether a typed tree exists already. If yes, the typed tree is returned as result. Otherwise, we proceed with regular type checking.

The scheme is designed to allow sharing of nodes, as long as each duplicate appears in a different method.

trait NoChecking extends ReChecking
object NoLift extends Lifter

No lifting at all

No lifting at all

object Nullables

Operations for implementing a flow analysis for nullability

Operations for implementing a flow analysis for nullability

case class OpenSearch(cand: Candidate, pt: Type, outer: SearchHistory)(using `x$4`: Context) extends SearchHistory
object ProtoTypes

Type quotes '{ ... } and splices ${ ... }

Type quotes '{ ... } and splices ${ ... }

trait ReChecking extends Checking
class ReTyper extends Typer with ReChecking

A version of Typer that keeps all symbols defined and referenced in a previously typed tree.

A version of Typer that keeps all symbols defined and referenced in a previously typed tree.

All definition nodes keep their symbols. All leaf nodes for idents, selects, and TypeTrees keep their types. Indexing is a no-op.

Otherwise, everything is as in Typer.

object RefChecks
Companion
class
class RefChecks extends MiniPhase

Post-attribution checking and transformation, which fulfills the following roles

Post-attribution checking and transformation, which fulfills the following roles

  1. This phase performs the following checks.
  • only one overloaded alternative defines default arguments
  • applyDynamic methods are not overloaded
  • all overrides conform to rules laid down by checkAllOverrides.
  • any value classes conform to rules laid down by checkDerivedValueClass.
  • this(...) constructor calls do not forward reference other definitions in their block (not even lazy vals).
  • no forward reference in a local block jumps over a non-lazy val definition.
  • a class and its companion object do not both define a class or module with the same name.
  1. It warns about references to symbols labeled deprecated or migration.

  2. It eliminates macro definitions.

  3. It makes members not private where necessary. The following members cannot be private in the Java model:

  • term members of traits
  • the primary constructor of a value class
  • the parameter accessor of a value class
  • members accessed from an inner or companion class. All these members are marked as NotJavaPrivate. Unlike in Scala 2.x not-private members keep their name. It is up to the backend to find a unique expanded name for them. The rationale to do name changes that late is that they are very fragile.

todo: But RefChecks is not done yet. It's still a somewhat dirty port from the Scala 2 version. todo: move untrivial logic to their own mini-phases

Companion
object
abstract class SearchHistory

Records the history of currently open implicit searches.

Records the history of currently open implicit searches.

A search history maintains a list of open implicit searches (openSearchPairs) a shortcut flag indicating whether any of these are by name (byname) and a reference to the root search history (root) which in turn maintains a possibly empty dictionary of recursive implicit terms constructed during this search.

A search history provides operations to create a nested search history, check for divergence, enter by name references and definitions in the implicit dictionary, lookup recursive references and emit a complete implicit dictionary when the outermost search is complete.

final class SearchRoot extends SearchHistory

The the state corresponding to the outermost context of an implicit searcch.

The the state corresponding to the outermost context of an implicit searcch.

class Synthesizer(typer: Typer)(using @constructorOnly c: Context)

Synthesize terms for special classes

Synthesize terms for special classes

sealed class TermRefSet(using `x$1`: Context)

A set of term references where equality is =:=

A set of term references where equality is =:=

Companion
object
object TermRefSet
Companion
class
Companion
object
object TypeAssigner extends TypeAssigner
Companion
class
object Typer
Companion
class
Companion
object

Provides check method to check that all top-level definitions in tree are variance correct. Does not recurse inside methods. The method should be invoked once for each Template.

Provides check method to check that all top-level definitions in tree are variance correct. Does not recurse inside methods. The method should be invoked once for each Template.

Companion
class
class VarianceChecker(using `x$1`: Context)
Companion
object