Packages

  • package root

    The Scala compiler and reflection APIs.

    The Scala compiler and reflection APIs.

    Definition Classes
    root
  • package scala
    Definition Classes
    root
  • package tools
    Definition Classes
    scala
  • package nsc
    Definition Classes
    tools
  • package interpreter

    The main REPL related classes and values are as follows.

    The main REPL related classes and values are as follows. In addition to standard compiler classes Global and Settings, there are:

    History: an interface for session history. Completion: an interface for tab completion. ILoop (formerly InterpreterLoop): The umbrella class for a session. IMain (formerly Interpreter): Handles the evolving state of the session and handles submitting code to the compiler and handling the output. InteractiveReader: how ILoop obtains input. History: an interface for session history. Completion: an interface for tab completion. Power: a repository for more advanced/experimental features.

    ILoop contains { in: InteractiveReader, intp: IMain, settings: Settings, power: Power } InteractiveReader contains { history: History, completion: Completion } IMain contains { global: Global }

    Definition Classes
    nsc
  • class ILoop extends LoopCommands

    The Scala interactive shell.

    The Scala interactive shell. It provides a read-eval-print loop around the Interpreter class. After instantiation, clients should call the main() method.

    If no in0 is specified, then input will come from the console, and the class will attempt to provide input editing feature such as input history.

    Definition Classes
    interpreter
    Version

    1.2

  • ILoopInterpreter
  • LineCmd
  • LineResults
  • LoopCommand
  • NullaryCmd
  • ReplCompletion
  • Result
  • VarArgsCmd
c

scala.tools.nsc.interpreter.ILoop

ILoopInterpreter

class ILoopInterpreter extends IMain

Source
ILoop.scala
Linear Supertypes
IMain, PresentationCompilation, Imports, AnyRef, Any
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. ILoopInterpreter
  2. IMain
  3. PresentationCompilation
  4. Imports
  5. AnyRef
  6. Any
Implicitly
  1. by IMainOps
  2. by any2stringadd
  3. by StringFormat
  4. by Ensuring
  5. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new ILoopInterpreter()

Type Members

  1. abstract class PhaseDependentOps extends AnyRef
    Definition Classes
    IMain
  2. class ReadEvalPrint extends AnyRef

    Here is where we:

    Here is where we:

    1) Read some source code, and put it in the "read" object. 2) Evaluate the read object, and put the result in the "eval" object. 3) Create a String for human consumption, and put it in the "print" object.

    Read! Eval! Print! Some of that not yet centralized here.

    Definition Classes
    IMain
  3. implicit class ReplTypeOps extends AnyRef
    Definition Classes
    IMain
  4. class Request extends AnyRef

    One line of code submitted by the user for interpretation

    One line of code submitted by the user for interpretation

    Definition Classes
    IMain
  5. case class ComputedImports(header: String, prepend: String, append: String, access: String) extends Product with Serializable

    Compute imports that allow definitions from previous requests to be visible in a new request.

    Compute imports that allow definitions from previous requests to be visible in a new request. Returns three or four pieces of related code:

    0. Header code fragment that should go at the beginning of the compilation unit, specifically, import Predef.

    1. An initial code fragment that should go before the code of the new request.

    2. A code fragment that should go after the code of the new request.

    3. An access path which can be traversed to access any bindings inside code wrapped by #1 and #2 .

    The argument is a set of Names that need to be imported.

    Limitations: This method is not as precise as it could be. (1) It does not process wildcard imports to see what exactly they import. (2) If it imports any names from a request, it imports all of them, which is not really necessary. (3) It imports multiple same-named implicits, but only the last one imported is actually usable.

    Definition Classes
    Imports
  6. abstract class PresentationCompileResult extends AnyRef
    Definition Classes
    PresentationCompilation

Value Members

  1. def addUrlsToClassPath(urls: URL*): Unit

    Adds all specified jars to the compile and runtime classpaths.

    Adds all specified jars to the compile and runtime classpaths.

    urls

    The list of items to add to the compile and runtime classpaths.

    Definition Classes
    IMain
    Note

    Currently only supports jars, not directories.

  2. def allDefinedNames: List[Global.Name]
    Definition Classes
    IMain
  3. def allHandlers: collection.immutable.List[(memberHandlers)#MemberHandler]
    Definition Classes
    IMain
  4. def allImportedNames: collection.immutable.List[Global.Name]
    Definition Classes
    Imports
  5. def backticked(s: String): String
    Definition Classes
    IMain
  6. def beQuietDuring[T](body: ⇒ T): T

    Temporarily be quiet

    Temporarily be quiet

    Definition Classes
    IMain
  7. def beSilentDuring[T](operation: ⇒ T): T
    Definition Classes
    IMain
  8. def bind[T](name: String, value: T)(implicit arg0: reflect.api.JavaUniverse.TypeTag[T], arg1: ClassTag[T]): Results.Result
    Definition Classes
    IMain
  9. def bind(p: NamedParam): Results.Result
    Definition Classes
    IMain
  10. def bind(name: String, boundType: String, value: Any, modifiers: List[String] = Nil): Results.Result

    Bind a specified name to a specified value.

    Bind a specified name to a specified value. The name may later be used by expressions passed to interpret.

    A fresh ReadEvalPrint, which defines a line package, is used to compile a custom eval object that wraps the bound value.

    If the bound value is successfully installed, then bind the name by interpreting val name = $line42.$eval.value.

    name

    the variable name to bind

    boundType

    the type of the variable, as a string

    value

    the object value to bind to it

    returns

    an indication of whether the binding succeeded

    Definition Classes
    IMain
  11. def classLoader: util.AbstractFileClassLoader
    Definition Classes
    IMain
  12. def classOfTerm(id: String): Option[JClass]
    Definition Classes
    IMain
  13. def cleanMemberDecl(owner: Global.Symbol, member: Global.Name): Global.Type
    Definition Classes
    IMain
  14. def cleanTypeAfterTyper(sym: ⇒ Global.Symbol): Global.Type
    Definition Classes
    IMain
  15. def clearExecutionWrapper(): Unit
    Definition Classes
    IMain
  16. def close(): Unit

    This instance is no longer needed, so release any resources it is using.

    This instance is no longer needed, so release any resources it is using. The reporter's output gets flushed.

    Definition Classes
    IMain
  17. def compileSources(sources: SourceFile*): Boolean

    Compile an nsc SourceFile.

    Compile an nsc SourceFile. Returns true if there are no compilation errors, or false otherwise.

    Definition Classes
    IMain
  18. def compileSourcesKeepingRun(sources: SourceFile*): (Boolean, Run)
    Definition Classes
    IMain
  19. def compileString(code: String): Boolean

    Compile a string.

    Compile a string. Returns true if there are no compilation errors, or false otherwise.

    Definition Classes
    IMain
  20. def compilerClasspath: Seq[URL]
    Definition Classes
    IMain
  21. def dealiasNonPublic(tp: Global.Type): Global.Type
    Definition Classes
    IMain
  22. def debugging[T](msg: String)(res: T): T
    Definition Classes
    IMain
  23. def definedSymbolList: collection.immutable.List[Global.Symbol]
    Definition Classes
    IMain
  24. def definedTerms: collection.immutable.List[Global.TermName]
    Definition Classes
    IMain
  25. def definedTypes: List[Global.TypeName]
    Definition Classes
    IMain
  26. def directBind[T](name: String, value: T)(implicit arg0: reflect.api.JavaUniverse.TypeTag[T], arg1: ClassTag[T]): Results.Result
    Definition Classes
    IMain
  27. def directBind(p: NamedParam): Results.Result
    Definition Classes
    IMain
  28. def directBind(name: String, boundType: String, value: Any): Results.Result
    Definition Classes
    IMain
  29. def echoKind: ((tpe: _1.intp.global.Type, kind: _1.intp.global.Kind, verbose: Boolean)Unit) forSome {val _1: IMainOps}
    Implicit
    This member is added by an implicit conversion from ILoopInterpreter to IMainOps performed by method IMainOps in scala.tools.nsc.interpreter.
    Definition Classes
    IMainOps
  30. def echoTypeSignature: ((sym: _1.intp.global.Symbol, verbose: Boolean)Unit) forSome {val _1: IMainOps}
    Implicit
    This member is added by an implicit conversion from ILoopInterpreter to IMainOps performed by method IMainOps in scala.tools.nsc.interpreter.
    Definition Classes
    IMainOps
  31. def echoTypeStructure: ((sym: _1.intp.global.Symbol)Unit) forSome {val _1: IMainOps}
    Implicit
    This member is added by an implicit conversion from ILoopInterpreter to IMainOps performed by method IMainOps in scala.tools.nsc.interpreter.
    Definition Classes
    IMainOps
  32. final def ensureClassLoader(): Unit
    Definition Classes
    IMain
  33. def executionWrapper: String
    Definition Classes
    IMain
  34. def finalize(): Unit
    Definition Classes
    IMain → AnyRef
  35. def flatPath(sym: Global.Symbol): String
    Definition Classes
    IMain
  36. def getClassIfDefined(path: String): Global.Symbol
    Definition Classes
    IMain
  37. def getModuleIfDefined(path: String): Global.Symbol
    Definition Classes
    IMain
  38. lazy val global: Global
    Definition Classes
    IMain
  39. def implicitSymbolsBySource: List[(Global.Symbol, List[Global.Symbol])]
    Definition Classes
    Imports
  40. def implicitsCommand(line: String): String
    Implicit
    This member is added by an implicit conversion from ILoopInterpreter to IMainOps performed by method IMainOps in scala.tools.nsc.interpreter.
    Definition Classes
    IMainOps
  41. def importHandlers: collection.immutable.List[(memberHandlers)#ImportHandler]
    Definition Classes
    IMain
  42. def importedSymbols: collection.immutable.List[Global.Symbol]
    Definition Classes
    Imports
  43. def importedSymbolsBySource: List[(Global.Symbol, List[Global.Symbol])]

    Tuples of (source, imported symbols) in the order they were imported.

    Tuples of (source, imported symbols) in the order they were imported.

    Definition Classes
    Imports
  44. def importedTermSymbols: collection.immutable.List[Global.TermSymbol]
    Definition Classes
    Imports
  45. def initialize(postInitSignal: ⇒ Unit): Unit
    Definition Classes
    IMain
  46. def initializeSynchronous(): Unit
    Definition Classes
    IMain
  47. def interpret(line: String, synthetic: Boolean): Results.Result
    Definition Classes
    IMain
  48. def interpret(line: String): Results.Result

    Interpret one line of input.

    Interpret one line of input. All feedback, including parse errors and evaluation results, are printed via the supplied compiler's reporter. Values defined are available for future interpreted strings.

    The return value is whether the line was interpreter successfully, e.g. that there were no parse errors.

    Definition Classes
    IMain
  49. def interpretSynthetic(line: String): Results.Result
    Definition Classes
    IMain
  50. val intp: IMain
    Implicit
    This member is added by an implicit conversion from ILoopInterpreter to IMainOps performed by method IMainOps in scala.tools.nsc.interpreter.
    Definition Classes
    IMainOps
  51. lazy val isClassBased: Boolean
    Definition Classes
    IMain
  52. def isInitializeComplete: Boolean
    Definition Classes
    IMain
  53. lazy val isettings: ISettings

    interpreter settings

    interpreter settings

    Definition Classes
    IMain
  54. def kindCommandInternal(typeString: String, verbose: Boolean): Unit
    Implicit
    This member is added by an implicit conversion from ILoopInterpreter to IMainOps performed by method IMainOps in scala.tools.nsc.interpreter.
    Definition Classes
    IMainOps
  55. def languageSymbols: collection.immutable.List[Global.Symbol]
    Definition Classes
    Imports
  56. def languageWildcardHandlers: collection.immutable.List[(memberHandlers)#ImportHandler]
    Definition Classes
    Imports
  57. def languageWildcardSyms: List[Global.Symbol]

    Symbols whose contents are language-defined to be imported.

    Symbols whose contents are language-defined to be imported.

    Definition Classes
    Imports
  58. def lastRequest: Request
    Definition Classes
    IMain
  59. def lastWarnings: List[(Global.Position, String)]
    Definition Classes
    IMain
  60. lazy val memberHandlers: MemberHandlers { val intp: ILoopInterpreter.this.type }
    Definition Classes
    IMain
  61. def mostRecentVar: String

    Returns the name of the most recent interpreter result.

    Returns the name of the most recent interpreter result. Mostly this exists so you can conveniently invoke methods on the previous result.

    Definition Classes
    IMain
  62. def namedDefinedTerms: collection.immutable.List[Global.TermName]
    Definition Classes
    IMain
  63. def newPresentationCompiler(): interactive.Global

    Create an instance of the presentation compiler with a classpath comprising the REPL's configured classpath and the classes output by previously compiled REPL lines.

    Create an instance of the presentation compiler with a classpath comprising the REPL's configured classpath and the classes output by previously compiled REPL lines.

    You may directly interact with this compiler from any thread, although you must not access it concurrently from multiple threads.

    You may downcast the reporter to StoreReporter to access type errors.

    Definition Classes
    PresentationCompilation
  64. def originalPath(sym: Global.Symbol): String
    Definition Classes
    IMain
  65. def originalPath(name: Global.Name): String
    Definition Classes
    IMain
  66. def originalPath(name: String): String
    Definition Classes
    IMain
  67. var partialInput: String
    Definition Classes
    IMain
  68. def prevRequestList: collection.immutable.List[Request]
    Definition Classes
    IMain
  69. def printAfterTyper(msg: ⇒ String): Unit
    Implicit
    This member is added by an implicit conversion from ILoopInterpreter to IMainOps performed by method IMainOps in scala.tools.nsc.interpreter.
    Definition Classes
    IMainOps
  70. def quietBind(p: NamedParam): Results.Result
    Definition Classes
    IMain
  71. def quietRun[T](code: String): Results.Result
    Definition Classes
    IMain
  72. val readInstanceName: String

    For class based repl mode we use an .INSTANCE accessor.

    For class based repl mode we use an .INSTANCE accessor.

    Definition Classes
    IMain
  73. def readRootPath(readPath: String): Global.Symbol
    Definition Classes
    IMain
  74. def rebind(p: NamedParam): Results.Result
    Definition Classes
    IMain
  75. def recordRequest(req: Request): Unit
    Definition Classes
    IMain
  76. def replScope: Global.Scope
    Definition Classes
    IMain
  77. lazy val reporter: ReplReporter
    Definition Classes
    IMain
  78. def reset(): Unit

    Reset this interpreter, forgetting all user-specified requests.

    Reset this interpreter, forgetting all user-specified requests.

    Definition Classes
    IMain
  79. def resetClassLoader(): Unit
    Definition Classes
    IMain
  80. def runtimeClassAndTypeOfTerm(id: String): Option[(JClass, Global.Type)]
    Definition Classes
    IMain
  81. def runtimeMirror: Mirror
    Definition Classes
    IMain
  82. def runtimeTypeOfTerm(id: String): Global.Type
    Definition Classes
    IMain
  83. def sessionImportedSymbols: collection.immutable.List[Global.Symbol]
    Definition Classes
    Imports
  84. def sessionWildcards: List[Global.Type]

    Types which have been wildcard imported, such as: val x = "abc" ; import x._ // type java.lang.String import java.lang.String._ // object java.lang.String

    Types which have been wildcard imported, such as: val x = "abc" ; import x._ // type java.lang.String import java.lang.String._ // object java.lang.String

    Used by tab completion.

    XXX right now this gets import x._ and import java.lang.String._, but doesn't figure out import String._. There's a lot of ad hoc scope twiddling which should be swept away in favor of digging into the compiler scopes.

    Definition Classes
    Imports
  85. def setExecutionWrapper(code: String): Unit
    Definition Classes
    IMain
  86. def settings: Settings
    Definition Classes
    IMain
  87. def showCodeIfDebugging(code: String): Unit
    Definition Classes
    IMain
  88. def showDirectory(): Unit
    Definition Classes
    IMain
  89. def symbolDefString(sym: Global.Symbol): String
    Definition Classes
    IMain
  90. def symbolOfIdent(id: String): Global.Symbol
    Definition Classes
    IMain
  91. def symbolOfLine(code: String): Global.Symbol
    Definition Classes
    IMain
  92. def symbolOfName(id: Global.Name): Global.Symbol
    Definition Classes
    IMain
  93. def symbolOfTerm(id: String): Global.Symbol
    Definition Classes
    IMain
  94. def symbolOfType(id: String): Global.Symbol
    Definition Classes
    IMain
  95. def translateEnclosingClass(n: String): Option[String]
    Definition Classes
    IMain
  96. def translateOriginalPath(p: String): String
    Definition Classes
    IMain
  97. def translatePath(path: String): Option[String]
    Definition Classes
    IMain
  98. def translateSimpleResource(path: String): Option[String]

    If path represents a class resource in the default package, see if the corresponding symbol has a class file that is a REPL artifact residing at a different resource path.

    If path represents a class resource in the default package, see if the corresponding symbol has a class file that is a REPL artifact residing at a different resource path. Translate X.class to $line3/$read$$iw$$iw$X.class.

    Definition Classes
    IMain
  99. def tryTwice(op: ⇒ Global.Symbol): Global.Symbol

    It's a bit of a shotgun approach, but for now we will gain in robustness.

    It's a bit of a shotgun approach, but for now we will gain in robustness. Try a symbol-producing operation at phase typer, and if that is NoSymbol, try again at phase flatten. I'll be able to lose this and run only from exitingTyper as soon as I figure out exactly where a flat name is sneaking in when calculating imports.

    Definition Classes
    IMain
  100. def typeCommandInternal(expr: String, verbose: Boolean): Unit

    TODO - -n normalize -l label with case class parameter names -c complete - leave nothing out

    TODO - -n normalize -l label with case class parameter names -c complete - leave nothing out

    Implicit
    This member is added by an implicit conversion from ILoopInterpreter to IMainOps performed by method IMainOps in scala.tools.nsc.interpreter.
    Definition Classes
    IMainOps
  101. def typeOfExpression(expr: String, silent: Boolean = true): Global.Type
    Definition Classes
    IMain
  102. def typeOfTerm(id: String): Global.Type
    Definition Classes
    IMain
  103. def unqualifiedIds: List[String]
    Definition Classes
    IMain
  104. def valueOfTerm(id: String): Option[Any]
    Definition Classes
    IMain
  105. def withLabel[A](temp: String)(body: ⇒ A): A
    Definition Classes
    IMain
  106. def withoutTruncating[A](body: ⇒ A): A
    Definition Classes
    IMain
  107. def withoutUnwrapping(op: ⇒ Unit): Unit
    Definition Classes
    IMain
  108. def withoutWarnings[T](body: ⇒ T): T
    Definition Classes
    IMain
  109. object deconstruct extends StructuredTypeStrings
    Definition Classes
    IMain
  110. object exprTyper extends ExprTyper
    Definition Classes
    IMain
  111. object flatOp extends PhaseDependentOps
    Definition Classes
    IMain
  112. object naming extends Naming
    Definition Classes
    IMain
  113. object parse

    Parse a line into and return parsing result (error, incomplete or success with list of trees)

    Parse a line into and return parsing result (error, incomplete or success with list of trees)

    Definition Classes
    IMain
  114. object replOutput extends ReplOutput
    Definition Classes
    IMain
  115. object typerOp extends PhaseDependentOps
    Definition Classes
    IMain
  116. object PresentationCompileResult
    Definition Classes
    PresentationCompilation

Deprecated Value Members

  1. def setContextClassLoader(): Unit
    Definition Classes
    IMain
    Annotations
    @deprecated
    Deprecated

    (Since version 2.12.0) The thread context classloader is now set and restored around execution of REPL line, this method is now a no-op.

  2. def virtualDirectory: ReplDir
    Definition Classes
    IMain
    Annotations
    @deprecated
    Deprecated

    (Since version 2.11.0) Use replOutput.dir instead