Berkeley DB: Dbc.close
Description: Berkeley DB: An embedded database programmatic toolkit.
Keywords: embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++

# Dbc.close |

`

###

    import com.sleepycat.db.*;

    public void close()
        throws DbException;

# Description

The Dbc.close method discards the cursor.

It is possible for the Dbc.close method to return Db.DB_LOCK_DEADLOCK, signaling that any enclosing transaction should be aborted. If the application is already intending to abort the transaction, this error should be ignored, and the application should proceed.

After Dbc.close has been called, regardless of its return, the cursor handle may not be used again.

The Dbc.close method throws an exception that encapsulates a non-zero error value on failure.

# Errors

The Dbc.close method may fail and throw an exception encapsulating a non-zero error for the following conditions:

EINVAL
  An invalid flag value or parameter was specified.

  The cursor was previously closed.

If the operation was selected to resolve a deadlock, the Dbc.close method will fail and throw a DbDeadlockException exception.

The Dbc.close method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. If a catastrophic error has occurred, the Dbc.close method may fail and throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way.

# Class

Dbc

# See Also

Dbc.close, Dbc.count, Dbc.del, Dbc.dup, Dbc.get, Dbc.pget, and Dbc.put.`

Copyright Sleepycat Software