ddCreateLib

ddCreateLib( 
t_libName 
[ t_libPath ] 
)
=> b_ddId 

Description

Searches for the named library in the library list.

If the library does not exist, ddCreateLib creates the corresponding directory and adds the DEFINE command to the library list file (it uses ddUpdateLibList’s search to find the cds.lib file and, if that file is not in the current working directory, it creates a new cds.lib file in the current working directory and adds the DEFINE statement to it as well as a SOFTINCLUDE statement to include the file found by ddUpdateLibList’s search). Finally, if successful, it returns the ID of the new library.

If you do not include t_libPath, DDPI uses the current working directory and libName to make a path (cwd/libName). If you specify a leaf name (one without embedded separators), DDPI makes a path out of that name and the current working directory (cwd/libPath). If you specify “.” or “..”, DDPI does the same as for NULL.

The cdsinfo.tag file keeps track of which design management system is managing a library. This file resides in the library directory. It contains one string, which is the name of the design management system.

ddCreateLib calls back trigger functions registered on the triggers PreCreateLib and PostCreateLib. The PostCreateObj trigger is not called when a library is created with ddCreateLib.

Arguments

t_libName	Name of the library to create.
t_libPath	Absolute or relative directory name where the library is created. A relative path is interpreted relative to the current directory. If t_libPath is omitted, nil, or an empty string (" "), the library is created in the current working directory.

Value Returned

b_ddId

The ID of the library.

Examples

TTL7400libraryId = ddCreateLib( "TTL7400_series" )

Return to top