scala.util.control

# Exception

#### object Exception

Classes representing the components of exception handling. Each class is independently composable. Some example usages:

    import scala.util.control.Exception._
    import java.net._

    val s = "http://www.scala-lang.org/"
    val x1 = catching(classOf[MalformedURLException]) opt new URL(s)
    val x2 = catching(classOf[MalformedURLException], classOf[NullPointerException]) either new URL(s)

This class differs from `scala.util.Try` in that it focuses on composing exception handlers rather than composing behavior. All behavior should be composed first and fed to a `Catch` object using one of the `opt` or `either` methods.

Source
  Exception.scala

Linear Supertypes
AnyRef, Any
Content Hierarchy Learn more about scaladoc diagrams
Ordering

1. Alphabetic
2. By inheritance

Inherited

1. Exception
2. AnyRef
3. Any

1. Hide All
2. Show all

Learn more about member selection
Visibility

1. Public
2. All

### Type Members

1. #### class By[T, R] extends AnyRef

   Returns a partially constructed `Catch` object, which you must give an exception handler function as an argument to `by`.

   Returns a partially constructed `Catch` object, which you must give an exception handler function as an argument to `by`. Example:

       handling(ex1, ex2) by (_.printStackTrace)

2. #### class Catch[+T] extends Described

   A container class for catch/finally logic.

   A container class for catch/finally logic.

   Pass a different value for rethrow if you want to probably unwisely allow catching control exceptions and other throwables which the rest of the world may expect to get through.

3. #### type Catcher[+T] = PartialFunction[Throwable, T]

4. #### trait Described extends AnyRef

5. #### class Finally extends Described

   A container class for finally code.

### Value Members

1. #### final def !=(arg0: Any): Boolean

   Definition Classes
     AnyRef → Any

2. #### final def ##(): Int

   Definition Classes
     AnyRef → Any

3. #### final def ==(arg0: Any): Boolean

   Definition Classes
     AnyRef → Any

4. #### final def allCatch[T]: Catch[T]

   A `Catch` object which catches everything.

5. #### final def allCatcher[T]: Catcher[T]

6. #### final def asInstanceOf[T0]: T0

   Definition Classes
     Any

7. #### def catching[T](c: Catcher[T]): Catch[T]

8. #### def catching[T](exceptions: Class[_]*): Catch[T]

   Creates a `Catch` object which will catch any of the supplied exceptions.

   Creates a `Catch` object which will catch any of the supplied exceptions. Since the returned `Catch` object has no specific logic defined and will simply rethrow the exceptions it catches, you will typically want to call `opt` or `either` on the return value, or assign custom logic by calling "withApply".

   Note that `Catch` objects automatically rethrow `ControlExceptions` and others which should only be caught in exceptional circumstances. If you really want to catch exactly what you specify, use `catchingPromiscuously` instead.

9. #### def catchingPromiscuously[T](c: Catcher[T]): Catch[T]

10. #### def catchingPromiscuously[T](exceptions: Class[_]*): Catch[T]

    Creates a `Catch` object which will catch any of the supplied exceptions.

    Creates a `Catch` object which will catch any of the supplied exceptions. Unlike "catching" which filters out those in shouldRethrow, this one will catch whatever you ask of it: `ControlThrowable`, `InterruptedException`, `OutOfMemoryError`, you name it.

11. #### def clone(): AnyRef

    Attributes
      protected[java.lang]
    Definition Classes
      AnyRef
    Annotations
      @throws( ... )

12. #### final def eq(arg0: AnyRef): Boolean

    Definition Classes
      AnyRef

13. #### def equals(arg0: Any): Boolean

    Definition Classes
      AnyRef → Any

14. #### def failAsValue[T](exceptions: Class[_]*)(value: ⇒ T): Catch[T]

    Creates a `Catch` object which maps all the supplied exceptions to the given value.

15. #### def failing[T](exceptions: Class[_]*): Catch[Option[T]]

    Creates a `Catch` object which maps all the supplied exceptions to `None`.

16. #### def finalize(): Unit

    Attributes
      protected[java.lang]
    Definition Classes
      AnyRef
    Annotations
      @throws( classOf[java.lang.Throwable] )

17. #### final def getClass(): Class[_]

    Definition Classes
      AnyRef → Any

18. #### def handling[T](exceptions: Class[_]*): By[(Throwable) ⇒ T, Catch[T]]

19. #### def hashCode(): Int

    Definition Classes
      AnyRef → Any

20. #### def ignoring(exceptions: Class[_]*): Catch[Unit]

    Creates a `Catch` object which catches and ignores any of the supplied exceptions.

21. #### final def isInstanceOf[T0]: Boolean

    Definition Classes
      Any

22. #### def mkCatcher[Ex <: Throwable, T](isDef: (Ex) ⇒ Boolean, f: (Ex) ⇒ T)(implicit arg0: ClassTag[Ex]): Catcher[T]

23. #### def mkThrowableCatcher[T](isDef: (Throwable) ⇒ Boolean, f: (Throwable) ⇒ T): Catcher[T]

24. #### final def ne(arg0: AnyRef): Boolean

    Definition Classes
      AnyRef

25. #### final val noCatch: Catch[Nothing]

    The empty `Catch` object.

26. #### final def nonFatalCatch[T]: Catch[T]

    A `Catch` object witch catches non-fatal exceptions.

27. #### final def nonFatalCatcher[T]: Catcher[T]

28. #### final val nothingCatcher: Catcher[Nothing]

29. #### final def notify(): Unit

    Definition Classes
      AnyRef

30. #### final def notifyAll(): Unit

    Definition Classes
      AnyRef

31. #### def shouldRethrow(x: Throwable): Boolean

    !!! Not at all sure of every factor which goes into this, and/or whether we need multiple standard variations.

32. #### final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
      AnyRef

33. #### implicit def throwableSubtypeToCatcher[Ex <: Throwable, T](pf: PartialFunction[Ex, T])(implicit arg0: ClassTag[Ex]): Catcher[T]

34. #### def toString(): String

    Definition Classes
      AnyRef → Any

35. #### def ultimately[T](body: ⇒ Unit): Catch[T]

    Returns a `Catch` object with no catch logic and the argument as `Finally`.

36. #### def unwrapping[T](exceptions: Class[_]*): Catch[T]

    Creates a `Catch` object which unwraps any of the supplied exceptions.

37. #### final def wait(): Unit

    Definition Classes
      AnyRef
    Annotations
      @throws( ... )

38. #### final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
      AnyRef
    Annotations
      @throws( ... )

39. #### final def wait(arg0: Long): Unit

    Definition Classes
      AnyRef
    Annotations
      @throws( ... )

### Inherited from AnyRef

### Inherited from Any

### Ungrouped