UNLIBRARY

<< Click to Display Table of Contents >>

Navigation:  TCC > Commands >

UNLIBRARY
Purpose:Remove functions from the library function list

 

Format:UNLIBRARY [/Q /R file... (function ...)] function...

or

UNLIBRARY *

 

functionOne or more library functions to remove from memory.
fileOne or more files from which to read library functions to be undefined.

 

/Q(uiet)/R(ead file)

 

See also: FUNCTION and ESET.

 

Usage:

 

TCC maintains a list of the functions that you have defined. The UNLIBRARY command will remove functions from that list. UNLIBRARY supports wildcards in the function name.

 

To remove the function DDIR:

 

unlibrary ddir

 

To remove all the functions:

 

unlibrary *

 

To remove all the functions that begin with "DD":

 

unlibrary dd*

 

You can delete all matching library 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:

 

unlibrary (func1 func2) f*

 

If you keep functions in a file that can be loaded with the LIBRARY /R command, you can remove the functions by using the UNLIBRARY /R command with the same file name:

 

unlibrary /r function.lst

 

This is much faster than removing each function individually in a batch file, and can be more selective than using UNLIBRARY *.

 

Options:

 

/QPrevents UNLIBRARY from displaying an error message if one or more of the library functions do 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.

 

/RRead the list of functions to remove from a file. The file format should be the same format as that used by the LIBRARY /R command. You can use multiple files with one UNLIBRARY /R command by placing the names on the command line, separated by spaces:

 

unlibrary /r function1.lst function2.lst