HPUX RegInterp[3]

 Tk_RegisterInterp(3)                Tk                 Tk_RegisterInterp(3)

 Tk Library Procedures                                 Tk Library Procedures





 ___________________________________________________________________________

 NAME
      Tk_RegisterInterp -  make  an  interpreter  accessible  with  ``send''
      command

 SYNOPSIS
      #include <tk.h>

      int
      Tk_RegisterInterp(interp, name, tkwin)

 ARGUMENTS
      Tcl_Interp  *interp  (in)       Interpreter  to  register  in  display
                                     associated  with  tkwin.   Also used to
                                     return errors if registration failed.

      char        *name    (in)        Name   under   which   to    register
                                     interpreter.   Must be unique among all
                                     registered  interpreters  for   tkwin's
                                     display.  May not contain the character
                                     ``|''.

      Tk_Window   tkwin    (in)      Token for window.  Used only to find  a
                                     display in which to register interp.
 ___________________________________________________________________________


 DESCRIPTION
      Tk_RegisterInterp is invoked to associate a name  (name)  with  a  Tcl
      interpreter  (interp)  and  record  that  association  in a well-known
      property of a particular display (the one  containing  tkwin).   After
      this  procedure  has  been  invoked, other interpreters in the display
      will be able to use the send command to invoke operations remotely  in
      interp.   The  procedure  returns TCL_OK if the registration completed
      successfully and TCL_ERROR if the interpreter could not be  registered
      (e.g.  because  name  is  already  in use).  In the event of an error,
      interp->result is modified to point to a message describing the error.

      This procedure also adds a send command to interp,  so  that  commands
      may be sent from interp to other interpreters.

      The registration persists until the interpreter is deleted or the send
      command is deleted from interp, at which point interp is automatically
      unregistered.

      Tk_RegisterInterp is called automatically by  Tk_CreateMainWindow,  so
      applications don't normally need to call it explicitly.




                                    - 1 -        Formatted:  August 11, 1996






 Tk_RegisterInterp(3)                Tk                 Tk_RegisterInterp(3)

 Tk Library Procedures                                 Tk Library Procedures





 KEYWORDS
      interpreter, name, register, send command


















































                                    - 2 -        Formatted:  August 11, 1996