|Purpose:||Remove user-defined functions from the function list|
|Format:||UNFUNCTION [/Q /R file... (function ...)] function...|
|function||One or more functions to remove from memory.|
|file||One or more files from which to read functions to be undefined.|
TCC maintains a list of the functions that you have defined. The UNFUNCTION command will remove functions from that list. UNFUNCTION supports wildcards in the function name.
To remove the function DDIR:
To remove all the functions:
To remove all the functions that begin with "DD":
You can delete all matching functions except for those specified by enclosing the exceptions in parentheses. For example, to remove all functions beginning with "f" except for func1 and func2:
unfunction (func1 func2) f*
If you keep functions in a file that can be loaded with the FUNCTION /R command, you can remove the functions by using the UNFUNCTION /R command with the same file name:
unfunction /r function.lst
This is much faster than removing each function individually in a batch file, and can be more selective than using UNFUNCTION *.
|/Q||Prevents UNFUNCTION from displaying an error message if one or more of the functions does not exist. This option is most useful in batch files, for removing a group of functions when some of the functions may not have been defined.|
|/R||Read the list of functions to remove from a file. The file format should be the same format as that used by the FUNCTION /R command. You can use multiple files with one UNFUNCTION /R command by placing the names on the command line, separated by spaces:|
unfunction /r function1.lst function2.lst
UNFUNCTION /R will read from stdin if no filename is present and input is redirected.