The type of the symbol name.
The type of the symbol name.
Can be either TermName
or TypeName
depending on whether this is a TermSymbol
or a TypeSymbol
.
Type name namespaces do not intersect with term name namespaces.
This fact is reflected in different types for names of TermSymbol
and TypeSymbol
.
Returns all symbols overriden by this symbol.
A list of annotations attached to this Symbol.
Source file if this symbol is created during this compilation run, or a class file if this symbol is loaded from a *.
Source file if this symbol is created during this compilation run, or a class file if this symbol is loaded from a *.class or *.jar.
The return type is scala.reflect.io.AbstractFile
, which belongs to an experimental part of Scala reflection.
It should not be used unless you know what you are doing. In subsequent releases, this API will be refined
and exposed as a part of scala.reflect.api.
For a class: the module or case class factory with the same name in the same package.
For a class: the module or case class factory with the same name in the same package. For a module: the class with the same name in the same package. For all others: NoSymbol
Filters the underlying alternatives (or a single-element list composed of the symbol itself if the symbol is not overloaded).
Filters the underlying alternatives (or a single-element list composed of the symbol itself if the symbol is not overloaded). Returns an overloaded symbol is there are multiple matches. Returns a NoSymbol if there are no matches.
The encoded full path name of this symbol, where outer names and inner names are separated by periods.
Is this symbol labelled as "abstract override"?
Does this symbol or its underlying type represent a typechecking error?
Is this symbol final?
Does this symbol represent an implementation artifact that isn't meant for public use? Examples of such artifacts are erasure bridges and outer fields.
Does this symbol represent an implicit value, definition, class or parameter?
Is this symbol defined by Java?
Does this symbol represent a local declaration or definition?
Does this symbol represent a local declaration or definition?
If yes, either isPrivate
or isProtected
are guaranteed to be true.
Local symbols can only be accessed from the same object instance.
If yes, privateWithin
might tell more about this symbol's visibility scope.
Is this symbol a macro?
Is this symbol overriding something?
Does this symbol represent the definition of a package?
If yes, isTerm
is also guaranteed to be true.
Does this symbol represent a package class?
If yes, isClass
is also guaranteed to be true.
Is this symbol a parameter (either a method parameter or a type parameter)?
Does this symbol represent a private declaration or definition?
If yes, privateWithin
might tell more about this symbol's visibility scope.
Does this symbol represent a protected declaration or definition?
If yes, privateWithin
might tell more about this symbol's visibility scope.
Does this symbol represent a public declaration or definition?
Is this symbol a specialized type parameter or a generated specialized member?
Is this symbol static (i.
Is this symbol static (i.e. with no outer instance)? Q: When exactly is a sym marked as STATIC? A: If it's a member of a toplevel object, or of an object contained in a toplevel object, or any number of levels deep. http://groups.google.com/group/scala-internals/browse_thread/thread/d385bcd60b08faf6
Does this symbol represent a synthetic (i.
Does this symbol represent a synthetic (i.e. a compiler-generated) entity? Examples of synthetic entities are accessors for vals and vars or mixin constructors in trait implementation classes.
If this is a NoSymbol, returns NoSymbol, otherwise
returns the result of applying f
to this symbol.
The name of the symbol as a member of the Name
type.
Provides an alternate if symbol is a NoSymbol.
The owner of this symbol.
The owner of this symbol. This is the symbol
that directly contains the current symbol's definition.
The NoSymbol
symbol does not have an owner, and calling this method
on one causes an internal error.
The owner of the Scala root class scala.reflect.api.Mirror.RootClass
and the Scala root object scala.reflect.api.Mirror.RootPackage is NoSymbol
.
Every other symbol has a chain of owners that ends in
scala.reflect.api.Mirror.RootClass.
Set when symbol has a modifier of the form private[X], NoSymbol otherwise.
Set when symbol has a modifier of the form private[X], NoSymbol otherwise.
Access level encoding: there are three scala flags (PRIVATE, PROTECTED, and LOCAL) which combine with value privateWithin (the "foo" in private[foo]) to define from where an entity can be accessed. The meanings are as follows:
PRIVATE access restricted to class only. PROTECTED access restricted to class and subclasses only. LOCAL can only be set in conjunction with PRIVATE or PROTECTED. Further restricts access to the same object instance.
In addition, privateWithin can be used to set a visibility barrier. When set, everything contained in the named enclosing package or class has access. It is incompatible with PRIVATE or LOCAL, but is additive with PROTECTED (i.e. if either the flags or privateWithin allow access, then it is allowed.)
The java access levels translate as follows:
java private: isPrivate && (privateWithin == NoSymbol) java package: !isPrivate && !isProtected && (privateWithin == enclosingPackage) java protected: isProtected && (privateWithin == enclosingPackage) java public: !isPrivate && !isProtected && (privateWithin == NoSymbol)
Does the same as filter
, but crashes if there are multiple matches.
The type signature of this symbol.
The type signature of this symbol.
This method always returns signatures in the most generic way possible, even if the underlying symbol is obtained from an
instantiation of a generic type. For example, signature
of the method def map[B](f: (A) ⇒ B): List[B]
, which refers to the type parameter A
of the declaring class List[A]
,
will always feature A
, regardless of whether map
is loaded from the List[_]
or from List[Int]
. To get a signature
with type parameters appropriately instantiated, one should use typeSignatureIn
.
The type signature of this symbol seen as a member of given type site
.
Test two objects for inequality.
Test two objects for inequality.
true
if !(this == that), false otherwise.
Equivalent to x.hashCode
except for boxed numeric types and null
.
Equivalent to x.hashCode
except for boxed numeric types and null
.
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.
For null
returns a hashcode where null.hashCode
throws a
NullPointerException
.
a hash value consistent with ==
Test two objects for equality.
Test two objects for equality.
The expression x == that
is equivalent to if (x eq null) that eq null else x.equals(that)
.
true
if the receiver object is equivalent to the argument; false
otherwise.
This symbol cast to a ClassSymbol representing a class or trait.
This symbol cast to a ClassSymbol representing a class or trait.
if isClass
is false.
This symbol cast to a free term symbol.
This symbol cast to a free term symbol.
if isFreeTerm
is false.
This symbol cast to a free type symbol.
This symbol cast to a free type symbol.
if isFreeType
is false.
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 a ClassCastException
at
runtime, while the expression List(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.
the receiver object.
if the receiver object is not an instance of the erasure of type T0
.
This symbol cast to a MethodSymbol.
This symbol cast to a MethodSymbol.
if isMethod
is false.
This symbol cast to a ModuleSymbol defined by an object definition.
This symbol cast to a ModuleSymbol defined by an object definition.
if isModule
is false.
This symbol cast to a TermSymbol.
This symbol cast to a TermSymbol.
if isTerm
is false.
This symbol cast to a TypeSymbol.
This symbol cast to a TypeSymbol.
if isType
is false.
Create a copy of the receiver object.
Tests whether the argument (arg0
) is a reference to the receiver object (this
).
Tests whether the argument (arg0
) is a reference to the receiver object (this
).
The eq
method implements an equivalence relation on
non-null instances of AnyRef
, and has three additional properties:
x
and y
of type AnyRef
, multiple invocations of
x.eq(y)
consistently returns true
or consistently returns false
.x
of type AnyRef
, x.eq(null)
and null.eq(x)
returns false
.null.eq(null)
returns true
. When overriding the equals
or hashCode
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
).
true
if the argument is a reference to the receiver object; false
otherwise.
The equality method for reference types.
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 between finalize
and non-local returns
and exceptions, are all platform dependent.
Returns string formatted according to given format
string.
Returns string formatted according to given format
string.
Format strings are as for String.format
(@see java.lang.String.format).
A representation that corresponds to the dynamic class of the receiver object.
A representation that corresponds to the dynamic class of the receiver object.
The nature of the representation is platform dependent.
a representation that corresponds to the dynamic class of the receiver object.
not specified by SLS as a member of AnyRef
The hashCode method for reference types.
Does this symbol represent the definition of a class or trait?
If yes, isType
is also guaranteed to be true.
Does this symbol represent a free term captured by reification?
If yes, isTerm
is also guaranteed to be true.
Does this symbol represent a free type captured by reification?
If yes, isType
is also guaranteed to be true.
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 return false
, while the
expression List(1).isInstanceOf[List[String]]
will return true
.
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.
true
if the receiver object is an instance of erasure of type T0
; false
otherwise.
Does this symbol represent the definition of a method?
If yes, isTerm
is also guaranteed to be true.
Does this symbol represent the definition of a module (i.
Does this symbol represent the definition of a module (i.e. it
results from an object definition?).
If yes, isTerm
is also guaranteed to be true.
Does this symbol represent the definition of a class implicitly associated with an object definition (module class in scala compiler parlance).
Does this symbol represent the definition of a class implicitly associated
with an object definition (module class in scala compiler parlance).
If yes, isType
is also guaranteed to be true.
Used to provide a better error message for asMethod
Used to provide a better error message for asMethod
Does this symbol represent the definition of a term? Note that every symbol is either a term or a type.
Does this symbol represent the definition of a term?
Note that every symbol is either a term or a type.
So for every symbol sym
(except for NoSymbol
),
either sym.isTerm
is true or sym.isTerm
is true.
Does this symbol represent the definition of a type? Note that every symbol is either a term or a type.
Does this symbol represent the definition of a type?
Note that every symbol is either a term or a type.
So for every symbol sym
(except for NoSymbol
),
either sym.isTerm
is true or sym.isType
is true.
Equivalent to !(this eq that)
.
Equivalent to !(this eq that)
.
true
if the argument is not a reference to the receiver object; false
otherwise.
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.
not specified by SLS as a member of AnyRef
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.
not specified by SLS as a member of AnyRef
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.
a String representation of the object.
(symbolApi: StringAdd).self
(symbolApi: StringFormat).self
(symbolApi: ArrowAssoc[Universe.SymbolApi]).x
(Since version 2.10.0) Use leftOfArrow
instead
(symbolApi: Ensuring[Universe.SymbolApi]).x
(Since version 2.10.0) Use resultOfEnsuring
instead
These methods construct new symbols owned by the current symbol.
These methods enable collections-like operations on symbols.
The API of symbols. The main source of information about symbols is the Symbols page.
Class Symbol defines
isXXX
test methods such asisPublic
orisFinal
,params
andreturnType
methods for method symbols,baseClasses
for class symbols and so on. Some of these methods don't make sense for certain subclasses ofSymbol
and returnNoSymbol
,Nil
or other empty values.