rename(n) Tcl Built-In Commands rename(n)

```

```

# [NAME](#NAME)

rename - Rename or delete a command

# [SYNOPSIS](#SYNOPSIS)

**rename oldName newName**

```

```

# [DESCRIPTION](#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](#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](#SEE_ALSO)

[namespace(n)](/man/os/tcl/namespace.n), [proc(n)](/man/os/tcl/proc.n)

# [KEYWORDS](#KEYWORDS)

command, delete, namespace, rename

Tcl

---

Document: rename(n) from tcl 9.1.0-r2 (Chainguard OS)
Source: https://downloads.sourceforge.net/project/tcl/Tcl/9.1.0/tcl9.1.0-src.tar.gz