company logo

Application :: database - Get database handle

The function provides a database handle for the current context. When the function is called while running an OSI function or expression, the database handle from the current environment will be returned (data source). Otherwise, the utility context is checked and when running a utility, the database handle is returned from the utility data source.

When not running in a utility or OSI context, the function throws an exception.

Return value:  Database handle ( odaba::Database & )

The database handle refers to an (usually) opened database. Calling functions with invalid database handles may cause an exception. For checking the database handle, isValid() can be called.

Implementation details

odaba::Database Application  :: database (  )