+I#Berkeley DB: Dbc.del[P

Dbc.del





import com.sleepycat.db.*;

public int del(int flags) throws DbException;





Description



DThe Dbc.del method deletes the key/data pair currently referenced by the cursor.

EThe flags parameter is currently unused, and must be set to 0.

HThe cursor position is unchanged after a delete, and subsequent calls toGcursor functions expecting the cursor to reference an existing key willfail.

<If the element has already been deleted, Dbc.del will return DB_KEYEMPTY.

1If the cursor is not yet initialized, the Dbc.del4method throws an exception that encapsulates EINVAL.

Otherwise, the Dbc.delHmethod throws an exception that encapsulates an errno on failure.



Errors

OIf a fatal error occurs in Berkeley DB, the Dbc.del method may fail and throw a}DbRunRecoveryException, at which point all subsequent database%calls will also fail in the same way.

The Dbc.del&method may fail and throw an exceptionKfor any of the errors specified for the following Berkeley DB and C library functions:__account_page(3),dbenv->db_paniccall(3), fflush(3), fprintf(3),free(3),func(3),>DbLockTab.get,8DbLock.put,>DbLockTab.vec,6DbLog.put, malloc(3), memcpy(3), memmove(3),BDbMpoolFile.get,BDbMpoolFile.put,BDbMpoolFile.set, memset(3), realloc(3), strerror(3), vfprintf(3),and vsnprintf(3).

In addition, the Dbc.del&method may fail and throw an exceptionencapsulating errnofor the following conditions:

(

EAGAIN
A lock was unavailable.


B

EINVAL
An invalid flag value or parameter was specified.







Class

/Dbc



See Also

6Dbc.close,Dbc.del,1Dbc.getand2Dbc.put.
ÿÿ