object specializeTypes extends SpecializeTypes
- Alphabetic
- By Inheritance
- specializeTypes
- SpecializeTypes
- TypingTransformers
- InfoTransform
- Transform
- SubComponent
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Type Members
-
type
TypeEnv = Map[Global.Symbol, Global.Type]
- Definition Classes
- SpecializeTypes
-
abstract
class
StdPhase
extends GlobalPhase
A standard phase template
A standard phase template
- Definition Classes
- SubComponent
-
class
Phase
extends InfoTransform.Phase
- Definition Classes
- InfoTransform
-
case class
Abstract
(t: Global.Symbol) extends SpecializedInfo with Product with Serializable
Symbol is a specialized abstract method, either specialized or original.
Symbol is a specialized abstract method, either specialized or original. The original
t
is abstract.- Definition Classes
- SpecializeTypes
-
class
Duplicator
extends Duplicators
This duplicator additionally performs casts of expressions if that is allowed by the
casts
map.This duplicator additionally performs casts of expressions if that is allowed by the
casts
map.- Definition Classes
- SpecializeTypes
-
case class
Forward
(t: Global.Symbol) extends SpecializedInfo with Product with Serializable
Symbol is a method that should be forwarded to 't'
Symbol is a method that should be forwarded to 't'
- Definition Classes
- SpecializeTypes
-
case class
Implementation
(target: Global.Symbol) extends SpecializedInfo with Product with Serializable
Symbol is a specialized method whose body should be the target's method body.
Symbol is a specialized method whose body should be the target's method body.
- Definition Classes
- SpecializeTypes
-
class
ImplementationAdapter
extends Global.TreeSymSubstituter
A tree symbol substituter that substitutes on type skolems.
A tree symbol substituter that substitutes on type skolems. If a type parameter is a skolem, it looks for the original symbol in the 'from' and maps it to the corresponding new symbol. The new symbol should probably be a type skolem as well (not enforced).
All private members are made protected in order to be accessible from specialized classes.
- Definition Classes
- SpecializeTypes
-
case class
NormalizedMember
(target: Global.Symbol) extends SpecializedInfo with Product with Serializable
Symbol is a normalized member obtained by specializing 'target'.
Symbol is a normalized member obtained by specializing 'target'.
- Definition Classes
- SpecializeTypes
-
case class
Overload
(sym: Global.Symbol, env: TypeEnv) extends Product with Serializable
- Definition Classes
- SpecializeTypes
-
case class
SpecialOverload
(original: Global.Symbol, env: TypeEnv) extends SpecializedInfo with Product with Serializable
Symbol is a special overloaded method of 'original', in the environment env.
Symbol is a special overloaded method of 'original', in the environment env.
- Definition Classes
- SpecializeTypes
-
case class
SpecialOverride
(target: Global.Symbol) extends SpecializedInfo with Product with Serializable
Symbol is a specialized override paired with
target
.Symbol is a specialized override paired with
target
.- Definition Classes
- SpecializeTypes
-
case class
SpecialSuperAccessor
(t: Global.Symbol) extends SpecializedInfo with Product with Serializable
Symbol is a special overload of the super accessor.
Symbol is a special overload of the super accessor.
- Definition Classes
- SpecializeTypes
-
class
SpecializationDuplicator
extends Duplicator
Introduced to fix SI-7343: Phase ordering problem between Duplicators and Specialization.
Introduced to fix SI-7343: Phase ordering problem between Duplicators and Specialization. brief explanation: specialization rewires class parents during info transformation, and the new info then guides the tree changes. But if a symbol is created during duplication, which runs after specialization, its info is not visited and thus the corresponding tree is not specialized. One manifestation is the following:
object Test { class Parent[@specialized(Int) T]
def spec_method[@specialized(Int) T](t: T, expectedXSuper: String) = { class X extends Parent[T]() // even in the specialized variant, the local X class // doesn't extend Parent$mcI$sp, since its symbol has // been created after specialization and was not seen // by specialization's info transformer. ... } }
We fix this by forcing duplication to take place before specialization.
Note: The constructors phase (which also uses duplication) comes after erasure and uses the post-erasure typer => we must protect it from the beforeSpecialization phase shifting.
- Definition Classes
- SpecializeTypes
-
class
SpecializationPhase
extends Phase
- Definition Classes
- SpecializeTypes
-
class
SpecializationTransformer
extends Global.Transformer
- Definition Classes
- SpecializeTypes
-
case class
SpecializedAccessor
(target: Global.Symbol) extends SpecializedInfo with Product with Serializable
Symbol is a specialized accessor for the
target
field.Symbol is a specialized accessor for the
target
field.- Definition Classes
- SpecializeTypes
-
abstract
class
SpecializedInfo
extends AnyRef
- Definition Classes
- SpecializeTypes
-
case class
SpecializedInnerClass
(target: Global.Symbol, env: TypeEnv) extends SpecializedInfo with Product with Serializable
A specialized inner class that specializes original inner class
target
on a type parameter of the enclosing class, in the typeenvenv
.A specialized inner class that specializes original inner class
target
on a type parameter of the enclosing class, in the typeenvenv
.- Definition Classes
- SpecializeTypes
-
abstract
class
TypingTransformer
extends Global.Transformer
- Definition Classes
- TypingTransformers
Value Members
-
final
def
!=(arg0: Any): Boolean
Test two objects for inequality.
Test two objects for inequality.
- returns
true
if !(this == that), false otherwise.
- Definition Classes
- AnyRef → Any
-
final
def
##(): Int
Equivalent to
x.hashCode
except for boxed numeric types andnull
.Equivalent to
x.hashCode
except for boxed numeric types andnull
. For numerics, it returns a hash value which is consistent with value equality: if two value type instances compare as true, then ## will produce the same hash value for each of them. Fornull
returns a hashcode wherenull.hashCode
throws aNullPointerException
.- returns
a hash value consistent with ==
- Definition Classes
- AnyRef → Any
-
final
def
==(arg0: Any): Boolean
The expression
x == that
is equivalent toif (x eq null) that eq null else x.equals(that)
.The expression
x == that
is equivalent toif (x eq null) that eq null else x.equals(that)
.- returns
true
if the receiver object is equivalent to the argument;false
otherwise.
- Definition Classes
- AnyRef → Any
-
def
addConcreteSpecMethod(m: Global.Symbol): Unit
Add method m to the set of symbols for which we need an implementation tree in the tree transformer.
Add method m to the set of symbols for which we need an implementation tree in the tree transformer.
- Definition Classes
- SpecializeTypes
- Note
This field is part of the specializeTypes subcomponent, so any symbols that here are not garbage collected at the end of a compiler run!
-
final
def
afterOwnPhase[T](op: ⇒ T): T
- Definition Classes
- SubComponent
- Annotations
- @inline()
-
final
def
asInstanceOf[T0]: T0
Cast the receiver object to be of type
T0
.Cast the receiver object to be of type
T0
.Note that the success of a cast at runtime is modulo Scala's erasure semantics. Therefore the expression
1.asInstanceOf[String]
will throw aClassCastException
at runtime, while the expressionList(1).asInstanceOf[List[String]]
will not. In the latter example, because the type argument is erased as part of compilation it is not possible to check whether the contents of the list are of the requested type.- returns
the receiver object.
- Definition Classes
- Any
- Exceptions thrown
ClassCastException
if the receiver object is not an instance of the erasure of typeT0
.
-
final
def
beforeOwnPhase[T](op: ⇒ T): T
- Definition Classes
- SubComponent
- Annotations
- @inline()
-
def
changesBaseClasses: Boolean
This phase changes base classes.
This phase changes base classes.
- Definition Classes
- SpecializeTypes → InfoTransform
-
def
clone(): AnyRef
Create a copy of the receiver object.
Create a copy of the receiver object.
The default implementation of the
clone
method is platform dependent.- returns
a copy of the receiver object.
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
- Note
not specified by SLS as a member of AnyRef
-
def
concreteTypes(sym: Global.Symbol): List[Global.Type]
Return the types
sym
should be specialized at.Return the types
sym
should be specialized at. This may be some of the primitive types or AnyRef. AnyRef means that a new type parameter T will be generated later, known to be a subtype of AnyRef (T <: AnyRef). These are in a meaningful order for stability purposes.- Definition Classes
- SpecializeTypes
-
def
emptyEnv: TypeEnv
- Definition Classes
- SpecializeTypes
-
def
enabled: Boolean
Is this component enabled? Default is true.
Is this component enabled? Default is true.
- Definition Classes
- SubComponent
-
final
def
eq(arg0: AnyRef): Boolean
Tests whether the argument (
that
) is a reference to the receiver object (this
).Tests whether the argument (
that
) is a reference to the receiver object (this
).The
eq
method implements an equivalence relation on non-null instances ofAnyRef
, and has three additional properties:- It is consistent: for any non-null instances
x
andy
of typeAnyRef
, multiple invocations ofx.eq(y)
consistently returnstrue
or consistently returnsfalse
. - For any non-null instance
x
of typeAnyRef
,x.eq(null)
andnull.eq(x)
returnsfalse
. null.eq(null)
returnstrue
.
When overriding the
equals
orhashCode
methods, it is important to ensure that their behavior is consistent with reference equality. Therefore, if two objects are references to each other (o1 eq o2
), they should be equal to each other (o1 == o2
) and they should hash to the same value (o1.hashCode == o2.hashCode
).- returns
true
if the argument is a reference to the receiver object;false
otherwise.
- Definition Classes
- AnyRef
- It is consistent: for any non-null instances
-
def
equals(arg0: Any): Boolean
The equality method for reference types.
-
def
finalize(): Unit
Called by the garbage collector on the receiver object when there are no more references to the object.
Called by the garbage collector on the receiver object when there are no more references to the object.
The details of when and if the
finalize
method is invoked, as well as the interaction betweenfinalize
and non-local returns and exceptions, are all platform dependent.- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
- Note
not specified by SLS as a member of AnyRef
-
final
def
getClass(): Class[_]
Returns the runtime class representation of the object.
Returns the runtime class representation of the object.
- returns
a class object corresponding to the runtime type of the receiver.
- Definition Classes
- AnyRef → Any
-
val
global: Global.this.type
The global environment; overridden by instantiation in Global.
The global environment; overridden by instantiation in Global.
- Definition Classes
- specializeTypes → TypingTransformers → SubComponent
-
def
hasSpecializedParams(clazz: Global.Symbol): Boolean
Has
clazz
any type parameters that need be specialized?Has
clazz
any type parameters that need be specialized?- Definition Classes
- SpecializeTypes
-
def
hashCode(): Int
SubComponent are added to a HashSet and two phases are the same if they have the same name
SubComponent are added to a HashSet and two phases are the same if they have the same name
- returns
the hash code value for this object.
- Definition Classes
- SubComponent → AnyRef → Any
-
def
illegalSpecializedInheritance(clazz: Global.Symbol): Boolean
- Definition Classes
- SpecializeTypes
-
val
initial: Boolean
True if this phase runs before all other phases.
True if this phase runs before all other phases. Usually,
parser
.- Definition Classes
- SubComponent
-
val
internal: Boolean
True if this phase is not provided by a plug-in.
True if this phase is not provided by a plug-in.
- Definition Classes
- SubComponent
-
final
def
isInstanceOf[T0]: Boolean
Test whether the dynamic type of the receiver object is
T0
.Test whether the dynamic type of the receiver object is
T0
.Note that the result of the test is modulo Scala's erasure semantics. Therefore the expression
1.isInstanceOf[String]
will returnfalse
, while the expressionList(1).isInstanceOf[List[String]]
will returntrue
. In the latter example, because the type argument is erased as part of compilation it is not possible to check whether the contents of the list are of the specified type.- returns
true
if the receiver object is an instance of erasure of typeT0
;false
otherwise.
- Definition Classes
- Any
-
def
isNormalizedMember(m: Global.Symbol): Boolean
- Definition Classes
- SpecializeTypes
-
def
isSpecializedIn(sym: Global.Symbol, site: Global.Type): Boolean
Refines possiblySpecialized taking into account the instantiation of the specialized type variables at
site
Refines possiblySpecialized taking into account the instantiation of the specialized type variables at
site
- Definition Classes
- SpecializeTypes
-
def
keepsTypeParams: Boolean
- Definition Classes
- SpecializeTypes → InfoTransform
-
final
def
ne(arg0: AnyRef): Boolean
Equivalent to
!(this eq that)
.Equivalent to
!(this eq that)
.- returns
true
if the argument is not a reference to the receiver object;false
otherwise.
- Definition Classes
- AnyRef
-
def
newPhase(prev: nsc.Phase): StdPhase
Just to mark uncheckable
Just to mark uncheckable
- Definition Classes
- SpecializeTypes → InfoTransform → Transform → SubComponent
-
def
newTransformer(unit: Global.CompilationUnit): Global.Transformer
The transformer factory
The transformer factory
- Attributes
- protected
- Definition Classes
- SpecializeTypes → Transform
-
def
nonConflicting(env: TypeEnv): Boolean
Is any type variable in
env
conflicting with any if its type bounds, when type bindings inenv
are taken into account?Is any type variable in
env
conflicting with any if its type bounds, when type bindings inenv
are taken into account?A conflicting type environment could still be satisfiable.
- Definition Classes
- SpecializeTypes
-
final
def
notify(): Unit
Wakes up a single thread that is waiting on the receiver object's monitor.
Wakes up a single thread that is waiting on the receiver object's monitor.
- Definition Classes
- AnyRef
- Note
not specified by SLS as a member of AnyRef
-
final
def
notifyAll(): Unit
Wakes up all threads that are waiting on the receiver object's monitor.
Wakes up all threads that are waiting on the receiver object's monitor.
- Definition Classes
- AnyRef
- Note
not specified by SLS as a member of AnyRef
-
def
originalClass(clazz: Global.Symbol): Global.Symbol
Return the generic class corresponding to this specialized class.
Return the generic class corresponding to this specialized class.
- Definition Classes
- SpecializeTypes
-
def
ownPhase: nsc.Phase
The phase corresponding to this subcomponent in the current compiler run
The phase corresponding to this subcomponent in the current compiler run
- Definition Classes
- SubComponent
-
val
phaseName: String
the name of the phase:
the name of the phase:
- Definition Classes
- SpecializeTypes → SubComponent
-
def
phaseNewFlags: Long
The following flags may be set by this phase:
The following flags may be set by this phase:
- Definition Classes
- SpecializeTypes → SubComponent
-
def
phaseNextFlags: Long
New flags defined by the phase which are not valid until immediately after it
New flags defined by the phase which are not valid until immediately after it
- Definition Classes
- SubComponent
-
def
possiblySpecialized(sym: Global.Symbol): Boolean
Is
member
potentially affected by specialization? This is a gross overapproximation, but it should be okay for use outside of specialization.Is
member
potentially affected by specialization? This is a gross overapproximation, but it should be okay for use outside of specialization.- Definition Classes
- SpecializeTypes
-
def
produceTypeParameters(syms: List[Global.Symbol], nowner: Global.Symbol, env: TypeEnv): collection.immutable.List[Global.Symbol]
Produces the symbols from type parameters
syms
of the original owner, in the given type environmentenv
.Produces the symbols from type parameters
syms
of the original owner, in the given type environmentenv
. The new owner isnowner
.Non-specialized type parameters are cloned into new ones. Type parameters specialized on AnyRef have preexisting symbols.
For instance, a @specialized(AnyRef) T, will become T$sp <: AnyRef.
- Definition Classes
- SpecializeTypes
-
val
requires: List[String]
Names of phases required by this component.
Names of phases required by this component. Default is
Nil
.- Definition Classes
- SubComponent
-
val
runsAfter: collection.immutable.List[String]
Names of phases that must run before this phase.
Names of phases that must run before this phase.
- Definition Classes
- specializeTypes → SubComponent
-
val
runsBefore: List[String]
Names of phases that must run after this phase.
Names of phases that must run after this phase. Default is
Nil
.- Definition Classes
- SubComponent
-
val
runsRightAfter: Some[String]
Name of the phase that this phase must follow immediately.
Name of the phase that this phase must follow immediately.
- Definition Classes
- specializeTypes → SubComponent
-
def
satisfiabilityConstraints(env: TypeEnv): Option[TypeEnv]
- Definition Classes
- SpecializeTypes
-
def
satisfiable(env: TypeEnv, warnings: Boolean): Boolean
- Definition Classes
- SpecializeTypes
-
def
satisfiable(env: TypeEnv): Boolean
The type environment is sound w.r.t.
The type environment is sound w.r.t. to all type bounds or only soft conflicts appear. An environment is sound if all bindings are within the bounds of the given type variable. A soft conflict is a binding that does not fall within the bounds, but whose bounds contain type variables that are @specialized, (that could become satisfiable).
- Definition Classes
- SpecializeTypes
-
lazy val
specializableTypes: collection.immutable.List[Global.Type]
- Definition Classes
- SpecializeTypes
-
def
specializeCalls(unit: Global.CompilationUnit): TypingTransformer { ... /* 7 definitions in type refinement */ }
- Definition Classes
- SpecializeTypes
-
def
specializeClass(clazz: Global.Symbol, outerEnv: TypeEnv): List[Global.Symbol]
Specialize 'clazz', in the environment
outerEnv
.Specialize 'clazz', in the environment
outerEnv
. The outer environment contains bindings for specialized types of enclosing classes.A class C is specialized w.r.t to its own specialized type params
stps
, by specializing its members, and creating a new class for each combination ofstps
.- Definition Classes
- SpecializeTypes
-
val
specializedClass: HashMap[(Global.Symbol, TypeEnv), Global.Symbol]
For a given class and concrete type arguments, give its specialized class
For a given class and concrete type arguments, give its specialized class
- Definition Classes
- SpecializeTypes
-
def
specializedFunctionName(sym: Global.Symbol, args: List[Global.Type]): reflect.internal.Symbols.Symbol.NameType
- Definition Classes
- SpecializeTypes
-
def
specializedParams(sym: Global.Symbol): List[Global.Symbol]
Return specialized type parameters.
Return specialized type parameters.
- Definition Classes
- SpecializeTypes
-
val
specializedType: Global.TypeMap
- Definition Classes
- SpecializeTypes
-
def
specializedTypeVars(tpe: Global.Type): Set[Global.Symbol]
Return the set of @specialized type variables mentioned by the given type.
Return the set of @specialized type variables mentioned by the given type. It only counts type variables that appear:
- naked
- as arguments to type constructors in @specialized positions (arrays are considered as Array[@specialized T])
- Definition Classes
- SpecializeTypes
-
def
specializedTypeVars(sym: Global.Symbol): Set[Global.Symbol]
- Definition Classes
- SpecializeTypes
-
def
specializedTypeVars(tpes: List[Global.Type]): Set[Global.Symbol]
- Definition Classes
- SpecializeTypes
-
def
specializesClass(sym: Global.Symbol): Global.Symbol
If the symbol is the companion of a value class, the value class.
If the symbol is the companion of a value class, the value class. Otherwise, AnyRef.
- Definition Classes
- SpecializeTypes
-
def
survivingArgs(sym: Global.Symbol, args: List[Global.Type]): List[Global.Type]
Given an original class symbol and a list of types its type parameters are instantiated at returns a list of type parameters that should remain in the TypeRef when instantiating a specialized type.
Given an original class symbol and a list of types its type parameters are instantiated at returns a list of type parameters that should remain in the TypeRef when instantiating a specialized type.
- Definition Classes
- SpecializeTypes
-
def
survivingParams(params: List[Global.Symbol], env: TypeEnv): collection.immutable.List[Global.Symbol]
Type parameters that survive when specializing in the specified environment.
Type parameters that survive when specializing in the specified environment.
- Definition Classes
- SpecializeTypes
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
-
val
terminal: Boolean
True if this phase runs after all other phases.
True if this phase runs after all other phases. Usually,
terminal
.- Definition Classes
- SubComponent
-
def
toString(): String
Creates a String representation of this object.
Creates a String representation of this object. The default representation is platform dependent. On the java platform it is the concatenation of the class name, "@", and the object's hashcode in hexadecimal.
- returns
a String representation of the object.
- Definition Classes
- AnyRef → Any
-
def
transformInfo(sym: Global.Symbol, tpe: Global.Type): Global.Type
Type transformation.
Type transformation. It is applied to all symbols, compiled or loaded. If it is a 'no-specialization' run, it is applied only to loaded symbols.
- Definition Classes
- SpecializeTypes → InfoTransform
-
final
def
wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
object
SpecializedSuperConstructorCallArgument
- Definition Classes
- SpecializeTypes
-
object
TypeEnv
- Definition Classes
- SpecializeTypes
-
object
UnifyError
extends Throwable with ControlThrowable with Product with Serializable
- Definition Classes
- SpecializeTypes
The Scala compiler API.
The following resources are useful for Scala plugin/compiler development: