Function

Summary

Returns a database, given a database or database name.

Package

sql

Signature

find-database database &optional errorp => database, count

Arguments

database

A string or a database.

errorp

A boolean. Default value: t.

Values

database

A database.

count

An integer.

Description

The function find-database, given a string database, searches amongst the connected databases for one matching the name database.

If there is exactly one such database, it is returned and the second return value count is 1. If more than one databases match and errorp is nil, then the most recently connected of the matching databases is returned and count is the number of matches. If no matching database is found and errorp is nil, then nil is returned. If none, or more than one, matching databases are found and errorp is true, then an error is signaled.

If the argument database is a database, it is simply returned.

See also

connect
connected-databases
database-name
disconnect
status