atlReadFile

Reads an AST Object from a text file

Description:

This function creates an AST Object by reading the contents of a given text file. The file should contain a dump of an AST Object such as produced by the " atlShow" function.

Invocation

AstObject atlReadFile( const char fname, const char options, int status )

Arguments

fname
The file name.
options
Optional attribute settings for the Channel used to read the file.
status
Pointer to the global status variable.

Returned Value

A pointer to the Object read form the file, or NULL if no Object
could be read. A NULL pointer is also returned if an error occurs.