<< Click to Display Table of Contents >>

Navigation:  TCC > Commands >


Purpose:Create, modify, delete, or display library functions


Format:LIBRARY [/= /D func /F [func] /P /Q /R file ... /U]


/D(elete)/Q (no errors)
/F (display functions)/R(ead functions)
/P(ause)/U(pdate functions)




LIBRARY will load / display / delete library functions, which are similar to batch files but which are loaded into RAM and can be called as if they are internal commands. Library functions are read from files, with the syntax:


functionname {






The opening brace { must be on the same line as the function name (separated by a space), and the closing brace } must be on a line by itself.


When TCC starts, it will automatically load any library function files in the LIBRARY subdirectory of the TCC installation directory. You can specify a different location by setting the LibraryDirectory INI directive. You can have any number of functions in a file.


You can prevent TCC from loading library function files at startup with the TCC /IL option.


If you do not specify any switches, LIBRARY will display the library function names that match the command line argument(s). If you do not specify any arguments, LIBRARY will display all of the library function names.


Library functions can call aliases, internal or external commands, batch files, or other library functions.


The TCC parser will look for a matching library function name before looking for plugins, internal commands, external commands, or batch files.


The TCC startup option /IL will prevent loading the default library functions (from the Library folder).




/=Display the LIBRARY command dialog to help you set the command line options. The /= option can be anywhere on the line; additional options will set the appropriate fields in the command dialog.


/DDelete a function (the function name can contain wildcards)


/FDisplay the loaded (matching) functions (the function name can contain wildcards)


/PPause after each page when displaying functions


/QDon't display an error if deleting or updating functions that don't exist


/RRead function files. You can use multiple files with one LIBRARY /R command by placing the names on the command line, separated by spaces:


library /r function1.lst function2.lst


/UUpdate function (otherwise you will get an error when loading a function that already exists)