Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

rename (1t)

Name

rename - Rename or delete a command

Synopsis

rename oldName newName

Description

rename(1t)                   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 contain-
       ing 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
              }


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tcl-8    |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       namespace(n), proc(n)

KEYWORDS
       command, delete, namespace, rename



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source was downloaded from  http://prdownloads.sourceforge.net/tcl/tcl-
       core8.6.7-src.tar.gz

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tcl                                                                 rename(1t)