Release 5.  Copyright ©1994-1998 by TipTop Software, Inc.  All Rights Reserved.






TTExecutor




Inherits From: NSObject
Conforms To: NSCoding
Declared In: <ObjCore/TTExecutor.h>




Class Description

TTExecutor objects evaluate code in an interpreter.   An executor object keeps track of its interpreter.  This is how an executor object decides which interpreter object to use:

1. If an interpreter object is specified directly using -setInterp:, that interpreter is used.
2. If a remote interpreter is specified using -setConnectionName:, -setHostName:, and -setInterpName:, the executor will connect to the specified intepreter name on the specified host/connection name and use it.
3. Otherwise, if a language name is specified using -setLanguageName:, the default interpreter for that language is used.




Method Types

Specifying an interpreter setInterp:
interp
Specifying a remote interp setConnectionName:
connectionName
setHostName:
hostName
setInterpName:
interpName
Specifying interp language setLanguageName:
languageName
Other interpDidBecomeInvalid
connectToRemoteInterp




Instance Methods

connectionName
  (NSString*)connectionName

Returns the connection name.

See also:  -setConnectionName:




connectToRemoteInterp
  (id <TTInterpProtocol>)connectToRemoteInterp

This method is invoked when the executor object needs to connect to a remote interpreter (specified by hostName, connectionName, and interpName).  The method should return a proxy to the remote interpreter, or raise an exception if it cannot connect.  You should not invoke this method directly, but you can override it in order to provide custom connection behavior.

See also:  -hostName, -connectionName, -interpName




hostName
  (NSString*)hostName

Returns the host name for a remote interpreter.

See also:  -setHostName:




interp
  (id)interp

Returns the interpreter that is used to execute code.

See also:  -setInterp:




interpDidBecomeInvalid
  (void)interpDidBecomeInvalid

Notifies the the receiver that the interpreter did become invalid.  Do not send this message directly.




interpName
  (NSString*)interpName

Returns the interpreter name for a remote interpreter.

See also:  -setInterpName:




languageName
  (NSString*)languageName

Returns the language name for the selected interpreter.

See also:  -setLanguageName:




setConnectionName:
  (void)setConnectionName:(NSString*)n

Specifies a remote connection name for a remote interpreter.

See also:  -connectionName




setHostName:
  (void)setHostName:(NSString*)h

Specifies a remote host name for a remote interpreter.

See also:  -hostName




setInterp:
  (void)setInterp:i

Specifies the interpreter to be used to evaluate code.

See also:  -interp




setInterpName:
  (void)setInterpName:(NSString*)n

Specifies a remote interpreter name.

See also:  -interpName




setLanguageName:
  (void)setLanguageName:(NSString*)l

Specifies the interpreter language.

See also:  -languageName




###