通讯编程

开发平台：

Visual C++

rename.n：源码内容

							'"
'" Copyright (c) 1993 The Regents of the University of California.
'" Copyright (c) 1994-1997 Sun Microsystems, Inc.
'"
'" See the file "license.terms" for information on usage and redistribution
'" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'" 
'" RCS: @(#) $Id: rename.n,v 1.3.18.1 2004/10/27 14:23:58 dkf Exp $
'" 
.so man.macros
.TH rename n "" Tcl "Tcl Built-In Commands"
.BS
'" Note:  do not modify the .SH NAME line immediately below!
.SH NAME
rename - Rename or delete a command
.SH SYNOPSIS
fBrename fIoldName newNamefR
.BE
.SH DESCRIPTION
.PP
Rename the command that used to be called fIoldNamefR so that it
is now called fInewNamefR.
If fInewNamefR is an empty string then fIoldNamefR is deleted.
fIoldNamefR and fInewNamefR 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 fBrenamefR command returns an empty string as result.
.SH EXAMPLE
The fBrenamefR 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 fBsourcefR command is called:
.CS
fBrenamefR ::source ::theRealSource
set sourceCount 0
proc ::source args {
    global sourceCount
    puts "called source for the [incr sourceCount]'th time"
    uplevel 1 ::theRealSource $args
}
.CE
.SH "SEE ALSO"
namespace(n), proc(n)
.SH KEYWORDS
command, delete, namespace, rename

						