Tcl Built-In Commands                                  rename(1T)





NAME
     rename - Rename or delete a command

SYNOPSIS
     rename oldName newName



DESCRIPTION
     Rename the command that used to be called oldName so that it
     is  now  called newName.  If newName is an empty string then
     oldName  is  deleted.   oldName  and  newName  may   include
     namespace qualifiers (names of containing namespaces).  If a
     command is renamed into a different namespace, future  invo-
     cations of it will execute in the new namespace.  The rename
     command returns an empty string as result.

EXAMPLE
     The rename command can be used to wrap the standard Tcl com-
     mands  with your own monitoring machinery.  For example, you
     might wish to count how often the source command is called:
          rename ::source ::theRealSource
          set sourceCount 0
          proc ::source args {
              global sourceCount
              puts "called source for the [incr sourceCount]'th time"
              uplevel 1 ::theRealSource $args
          }


SEE ALSO
     namespace(1T), proc(1T)


KEYWORDS
     command, delete, namespace, rename

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:













Tcl                       Last change:                          1






Tcl Built-In Commands                                  rename(1T)



     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWTcl        
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for Tcl is available on http:/opensolaris.org.













































Tcl                       Last change:                          2