Scala Reflection Library2.13.17 < Back


# Packages

-  package root
  Definition Classes
    root
-  package scala
  Definition Classes
    root
-  package reflect
  Definition Classes
    scala
-  package macros

  EXPERIMENTAL

  EXPERIMENTAL

  The base package for Scala macros.

  Macros are functions that are called by the compiler during compilation. Within these functions the programmer has access to compiler APIs. For example, it is possible to generate, analyze and typecheck code.

  See the Macros Guide on how to get started with Scala macros.

  Definition Classes
    reflect
-  trait Enclosures extends AnyRef

  EXPERIMENTAL

  EXPERIMENTAL

  A slice of the Scala macros context that exposes enclosing trees (method, class, compilation unit and currently compiled macro application), the enclosing position of the macro expansion, as well as macros and implicits that are currently in-flight.

  Starting from Scala 2.11.0, the APIs to get the trees enclosing by the current macro application are deprecated, and the reasons for that are two-fold. Firstly, we would like to move towards the philosophy of locally-expanded macros, as it has proven to be important for understanding of code. Secondly, within the current architecture of scalac, we are unable to have c.enclosingTree-style APIs working robustly. Required changes to the typechecker would greatly exceed the effort that we would like to expend on this feature given the existence of more pressing concerns at the moment. This is somewhat aligned with the overall evolution of macros during the 2.11 development cycle, where we played with `c.introduceTopLevel` and `c.introduceMember`, but at the end of the day decided to reject them.

  If you're relying on the now deprecated APIs, consider using the new Internals.ContextInternalApi.enclosingOwner method that can be used to obtain the names of enclosing definitions. Alternatively try reformulating your macros in terms of completely local expansion and/or joining a discussion of a somewhat related potential language feature at https://groups.google.com/forum/#!topic/scala-debate/f4CLmYShX6Q. We also welcome questions and suggestions on our mailing lists, where we would be happy to further discuss this matter.

  Definition Classes
    macros
- EnclosureException

c

scala.reflect.macros.Enclosures

# EnclosureException

###

#### case class EnclosureException(expected: Class[_], enclosingTrees: List[blackbox.Context.Tree]) extends Exception with Product with Serializable

Indicates than one of the enclosure methods failed to find a tree of required type among enclosing trees.

Annotations
  @deprecated
Deprecated

  (Since version 2.11.0) c.enclosingTree-style APIs are now deprecated; consult the scaladoc for more information

Source
  Enclosures.scala
See also

  scala.reflect.macros.Enclosures

Linear Supertypes
Product, Equals, java.lang.Exception, java.lang.Throwable, java.io.Serializable, AnyRef, Any
Type Hierarchy

Ordering

1. Alphabetic
2. By Inheritance

Inherited

1. EnclosureException
2. Product
3. Equals
4. Exception
5. Throwable
6. Serializable
7. AnyRef
8. Any

Implicitly

1. by any2stringadd
2. by StringFormat
3. by Ensuring
4. by ArrowAssoc

1. Hide All
2. Show All

Visibility

1. Public
2. Protected

### Instance Constructors

1.  new EnclosureException(expected: Class[_], enclosingTrees: List[blackbox.Context.Tree])

### Value Members

1.  final def !=(arg0: Any): Boolean
   Definition Classes
     AnyRef → Any
2.  final def ##: Int
   Definition Classes
     AnyRef → Any
3.  def +(other: String): String
   Implicit
     This member is added by an implicit conversion from blackbox.Context.EnclosureException toany2stringadd[blackbox.Context.EnclosureException] performed by method any2stringadd in scala.Predef.
   Definition Classes
     any2stringadd
4.  def ->[B](y: B): (blackbox.Context.EnclosureException, B)
   Implicit
     This member is added by an implicit conversion from blackbox.Context.EnclosureException toArrowAssoc[blackbox.Context.EnclosureException] performed by method ArrowAssoc in scala.Predef.
   Definition Classes
     ArrowAssoc
   Annotations
     @inline()
5.  final def ==(arg0: Any): Boolean
   Definition Classes
     AnyRef → Any
6.  final def addSuppressed(arg0: java.lang.Throwable): Unit
   Definition Classes
     Throwable
7.  final def asInstanceOf[T0]: T0
   Definition Classes
     Any
8.  def clone(): AnyRef
   Attributes
     protected[lang]
   Definition Classes
     AnyRef
   Annotations
     @throws(classOf[java.lang.CloneNotSupportedException]) @native()
9.  val enclosingTrees: List[blackbox.Context.Tree]
10.  def ensuring(cond: (blackbox.Context.EnclosureException) => Boolean, msg: => Any): blackbox.Context.EnclosureException
    Implicit
      This member is added by an implicit conversion from blackbox.Context.EnclosureException toEnsuring[blackbox.Context.EnclosureException] performed by method Ensuring in scala.Predef.
    Definition Classes
      Ensuring
11.  def ensuring(cond: (blackbox.Context.EnclosureException) => Boolean): blackbox.Context.EnclosureException
    Implicit
      This member is added by an implicit conversion from blackbox.Context.EnclosureException toEnsuring[blackbox.Context.EnclosureException] performed by method Ensuring in scala.Predef.
    Definition Classes
      Ensuring
12.  def ensuring(cond: Boolean, msg: => Any): blackbox.Context.EnclosureException
    Implicit
      This member is added by an implicit conversion from blackbox.Context.EnclosureException toEnsuring[blackbox.Context.EnclosureException] performed by method Ensuring in scala.Predef.
    Definition Classes
      Ensuring
13.  def ensuring(cond: Boolean): blackbox.Context.EnclosureException
    Implicit
      This member is added by an implicit conversion from blackbox.Context.EnclosureException toEnsuring[blackbox.Context.EnclosureException] performed by method Ensuring in scala.Predef.
    Definition Classes
      Ensuring
14.  final def eq(arg0: AnyRef): Boolean
    Definition Classes
      AnyRef
15.  val expected: Class[_]
16.  def fillInStackTrace(): java.lang.Throwable
    Definition Classes
      Throwable
17.  def finalize(): Unit
    Attributes
      protected[lang]
    Definition Classes
      AnyRef
    Annotations
      @throws(classOf[java.lang.Throwable])
18.  def getCause(): java.lang.Throwable
    Definition Classes
      Throwable
19.  final def getClass(): Class[_ <: AnyRef]
    Definition Classes
      AnyRef → Any
    Annotations
      @native()
20.  def getLocalizedMessage(): String
    Definition Classes
      Throwable
21.  def getMessage(): String
    Definition Classes
      Throwable
22.  def getStackTrace(): Array[StackTraceElement]
    Definition Classes
      Throwable
23.  final def getSuppressed(): Array[java.lang.Throwable]
    Definition Classes
      Throwable
24.  def initCause(arg0: java.lang.Throwable): java.lang.Throwable
    Definition Classes
      Throwable
25.  final def isInstanceOf[T0]: Boolean
    Definition Classes
      Any
26.  final def ne(arg0: AnyRef): Boolean
    Definition Classes
      AnyRef
27.  final def notify(): Unit
    Definition Classes
      AnyRef
    Annotations
      @native()
28.  final def notifyAll(): Unit
    Definition Classes
      AnyRef
    Annotations
      @native()
29.  def printStackTrace(arg0: PrintWriter): Unit
    Definition Classes
      Throwable
30.  def printStackTrace(arg0: PrintStream): Unit
    Definition Classes
      Throwable
31.  def printStackTrace(): Unit
    Definition Classes
      Throwable
32.  def productElementNames: Iterator[String]
    Definition Classes
      Product
33.  def setStackTrace(arg0: Array[StackTraceElement]): Unit
    Definition Classes
      Throwable
34.  final def synchronized[T0](arg0: => T0): T0
    Definition Classes
      AnyRef
35.  def toString(): String
    Definition Classes
      Throwable → AnyRef → Any
36.  final def wait(): Unit
    Definition Classes
      AnyRef
    Annotations
      @throws(classOf[java.lang.InterruptedException])
37.  final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
      AnyRef
    Annotations
      @throws(classOf[java.lang.InterruptedException])
38.  final def wait(arg0: Long): Unit
    Definition Classes
      AnyRef
    Annotations
      @throws(classOf[java.lang.InterruptedException]) @native()

### Deprecated Value Members

1.  def formatted(fmtstr: String): String
   Implicit
     This member is added by an implicit conversion from blackbox.Context.EnclosureException toStringFormat[blackbox.Context.EnclosureException] performed by method StringFormat in scala.Predef.
   Definition Classes
     StringFormat
   Annotations
     @deprecated @inline()
   Deprecated

     (Since version 2.12.16) Use `formatString.format(value)` instead of `value.formatted(formatString)`, or use the `f""` string interpolator. In Java 15 and later, `formatted` resolves to the new method in String which has reversed parameters.

2.  def →[B](y: B): (blackbox.Context.EnclosureException, B)
   Implicit
     This member is added by an implicit conversion from blackbox.Context.EnclosureException toArrowAssoc[blackbox.Context.EnclosureException] performed by method ArrowAssoc in scala.Predef.
   Definition Classes
     ArrowAssoc
   Annotations
     @deprecated
   Deprecated

     (Since version 2.13.0) Use `->` instead. If you still wish to display it as one character, consider using a font with programming ligatures such as Fira Code.

### Inherited from Product

### Inherited from Equals

### Inherited from java.lang.Exception

### Inherited from java.lang.Throwable

### Inherited from java.io.Serializable

### Inherited from AnyRef

### Inherited from Any

### Inherited by implicit conversion any2stringadd fromblackbox.Context.EnclosureException to any2stringadd[blackbox.Context.EnclosureException]

### Inherited by implicit conversion StringFormat fromblackbox.Context.EnclosureException to StringFormat[blackbox.Context.EnclosureException]

### Inherited by implicit conversion Ensuring fromblackbox.Context.EnclosureException to Ensuring[blackbox.Context.EnclosureException]

### Inherited by implicit conversion ArrowAssoc fromblackbox.Context.EnclosureException to ArrowAssoc[blackbox.Context.EnclosureException]

### Ungrouped