|
Server : Apache/2.4.62 System : FreeBSD fbsdweb2.web.rcn.net 14.1-RELEASE FreeBSD 14.1-RELEASE releng/14.1-n267679-10e31f0946d8 GENERIC amd64 User : www ( 80) PHP Version : 8.3.8 Disable Function : NONE Directory : /usr/local/share/doc/db18/gsg/CXX/ |
Upload File : |
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Exception Handling</title>
<link rel="stylesheet" href="gettingStarted.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
<link rel="start" href="index.html" title="Getting Started with Berkeley DB" />
<link rel="up" href="introduction.html" title="Chapter 1. Introduction to Berkeley DB" />
<link rel="prev" href="environments.html" title="Environments" />
<link rel="next" href="returns.html" title="Error Returns" />
</head>
<body>
<div xmlns="" class="navheader">
<div class="libver">
<p>Library Version 18.1.40</p>
</div>
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Exception Handling</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="environments.html">Prev</a> </td>
<th width="60%" align="center">Chapter 1. Introduction to Berkeley DB </th>
<td width="20%" align="right"> <a accesskey="n" href="returns.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="coreExceptions"></a>Exception Handling</h2>
</div>
</div>
</div>
<p>
Before continuing, it is useful to spend a few moments on exception
handling in DB with the
<span>C++ API</span>.
</p>
<p>
<span>By default, most</span>
DB methods throw
<code class="classname">DbException</code>
in the event of a serious error.
</p>
<p>
You can obtain the DB error number for a
<code class="classname">DbException</code>
by using
<span>
<code class="methodname">DbException::get_errno()</code>.
You can also obtain the informational message associated with that error
number using <code class="methodname">DbException::what()</code>.
</span>
</p>
<p>
If for some reason you do not want to manage
<code class="classname">DbException</code> objects in your
<code class="literal">try</code> blocks, you can configure DB to suppress them
by setting <code class="literal">DB_CXX_NO_EXCEPTIONS</code> for your database and
environment handles. In this event, you must manage your DB error
conditions using the integer value returned by all DB methods. Be
aware that this manual assumes that you want to manage your error
conditions using <code class="classname">DbException</code> objects.
</p>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="environments.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="introduction.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="returns.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Environments </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> Error Returns</td>
</tr>
</table>
</div>
</body>
</html>