Scroll to navigation

rename(3tcl) Tcl Built-In Commands rename(3tcl) 





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 invocations 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
    commands 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(3tcl), proc(3tcl)






KEYWORDS


command, delete, namespace, rename







  

    
    Tcl