SDFREADALL(3SDF)

NAME
sdfreadallcir, sdfreadalllay - set of sealib routines to read a hierarchical subtree of objects from the seadif data base into main memory.

SYNOPSIS
 #include <sealib.h>
 extern LIBRARYPTR thislib;
 extern FUNCTIONPTR thisfun;
 extern CIRCUITPTR thiscir;
 extern LAYOUTPTR thislay;
 int sdfreadallcir(long what, STRING cirname,
                   STRING funname, STRING libname)
 int sdfreadalllay(long what, STRING layname, STRING cirname,
                   STRING funname, STRING libname)

DESCRIPTION
These functions read the named object and recursively all its child cells from a seadif data base and install the object and its children in an in-core tree. The root of the tree is sdfroot, see sealib(3SDF). The data base must have been opened with the sealib function sdfopen(3SDF). The parameter "what" specifies what attributes of the object must be read. Legal values are exactly as described in sdfread(3SDF). In fact, sdfreadall operates by repeatedly calling sdfread. (You could have written sdfreadall by yourself, but we provided it for your convenience...) The value of the global variables thislib, thisfun, thiscir and thislay refer to the specified parent cell, not to its children. See manual page of sdfread for details.

RETURN VALUE
Both functions return TRUE on succes and NIL on failure.

WARNINGS
Do not forget to canonicize the cell names before passing them to sdfread. See also Don't you dare to change the name of a cell. This would confuse the sealib internal administration and invalidate the hashtables !!! sealib(3SDF) and cs(3SDF).

AUTHOR
Paul Stravers, Delft University of Technology. E-mail address is ocean@donau.et.tudelft.nl.

SEE ALSO
sdfread(3SDF), sealib(3SDF), seadif(4SDF), sdfwrite(3SDF), sdfopen(3SDF), sdfclose(3SDF), cs(3SDF), sdfattachlib(3SDF), sdfexists(3SDF), memman(3SDF), sdfimage(4SDF).