1<!--$Id: del.so,v 1.11 2004/09/28 14:13:09 bostic Exp $--> 2<!--Copyright (c) 1997,2008 Oracle. All rights reserved.--> 3<!--See the file LICENSE for redistribution information.--> 4<html> 5<head> 6<title>Berkeley DB Reference Guide: Release 4.2: DB->del</title> 7<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> 8<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> 9</head> 10<body bgcolor=white> 11<table width="100%"><tr valign=top> 12<td><b><dl><dt>Berkeley DB Reference Guide:<dd>Upgrading Berkeley DB Applications</dl></b></td> 13<td align=right><a href="/upgrade.4.2/client.html"><img src="/images/prev.gif" alt="Prev"></a><a href="/toc.html"><img src="/images/ref.gif" alt="Ref"></a><a href="/upgrade.4.2/priority.html"><img src="/images/next.gif" alt="Next"></a> 14</td></tr></table> 15<p align=center><b>Release 4.2: DB->del</b></p> 16<p>In previous releases, the C++ <a href="/api_cxx/db_del.html">Db::del</a> and Java Db.delete 17methods threw exceptions encapsulating the <a href="/ref/program/errorret.html#DB_KEYEMPTY">DB_KEYEMPTY</a> error in 18some cases when called on Queue and Recno databases. Unfortunately, 19this was undocumented behavior.</p> 20<p>For consistency with the other Berkeley DB methods that handle 21<a href="/ref/program/errorret.html#DB_KEYEMPTY">DB_KEYEMPTY</a>, this is no longer the case. Applications calling 22the <a href="/api_cxx/db_del.html">Db::del</a> or Db.delete methods on Queue or Recno databases, 23and handling the <a href="/ref/program/errorret.html#DB_KEYEMPTY">DB_KEYEMPTY</a> exception specially, should be 24modified to check for a return value of <a href="/ref/program/errorret.html#DB_KEYEMPTY">DB_KEYEMPTY</a> instead.</p> 25<table width="100%"><tr><td><br></td><td align=right><a href="/upgrade.4.2/client.html"><img src="/images/prev.gif" alt="Prev"></a><a href="/toc.html"><img src="/images/ref.gif" alt="Ref"></a><a href="/upgrade.4.2/priority.html"><img src="/images/next.gif" alt="Next"></a> 26</td></tr></table> 27<p><font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 28</body> 29</html> 30