Understand::open()

Syntax

($db, $status) = Understand::open(path,[display]); 

Description

Open a database. Returns ($db, $status).

Arguments

The path argument specifies the database filename.

The display argument may be specified to change the display mode for Ada, FORTRAN, Pascal, and JOVIAL. If it is not specified, the default, as stored in the database is used. Display must be one of the following:

Return Values

$db is an object of the class Understand::Db.

If no error occurs, $status is undef. Otherwise, $status is:

Return Values
Description
DBAlreadyOpen
Only one database may be open at once
DBCorrupt
Sorry, bad database file
DBOldVersion
Database needs to be rebuilt
DBUnknownVersion
Database needs to be rebuilt
DBUnableOpen
Database is unreadable or does not exist
NoApiLicenseAda
Ada license required
NoApiLicenseC
C license required
NoApiLicenseFtn
FORTRAN license required
NoApiLicenseJava
Java license required
NoApiLicenseJovial
JOVIAL license required
NoApiLicensePascal
Pascal license required

Example

($db, $status) = Understand::open("test.udc"); 
die "Error status: ",$status,"\n" if $status; 

See Also

Opening a Database


Scientific Toolworks, Inc.
http://www.scitools.com