<?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>Storing records</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="Berkeley DB Programmer's Reference Guide" />
<link rel="up" href="am.html" title="Chapter 3. Access Method Operations" />
<link rel="prev" href="am_get.html" title="Retrieving records" />
<link rel="next" href="am_delete.html" title="Deleting records" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Storing records</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="am_get.html">Prev</a> </td>
<th width="60%" align="center">Chapter 3.
Access Method Operations
</th>
<td width="20%" align="right"> <a accesskey="n" href="am_delete.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="am_put"></a>Storing records</h2>
</div>
</div>
</div>
<p>The <a href="../api_reference/C/dbput.html" class="olink">DB->put()</a> method stores records into the database. In general,
<a href="../api_reference/C/dbput.html" class="olink">DB->put()</a> takes a key and stores the associated data into the
database.</p>
<p>There are a few flags that you can set to customize storage:</p>
<div class="variablelist">
<dl>
<dt>
<span class="term">
<a href="../api_reference/C/dbput.html#dbput_DB_APPEND" class="olink">DB_APPEND</a>
</span>
</dt>
<dd>Simply append the data to the end of the database, treating the database
much like a simple log. This flag is only valid for the Queue and Recno
access methods.</dd>
<dt>
<span class="term">
<a href="../api_reference/C/dbput.html#put_DB_NOOVERWRITE" class="olink">DB_NOOVERWRITE</a>
</span>
</dt>
<dd>Only store the data item if the key does not already appear in the database.</dd>
</dl>
</div>
<p>If the database has been configured to support duplicate records, the
<a href="../api_reference/C/dbput.html" class="olink">DB->put()</a> method will add the new data value at the end of the duplicate
set. If the database supports sorted duplicates, the new data value is
inserted at the correct sorted location.</p>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="am_get.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="am.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="am_delete.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Retrieving records </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> Deleting records</td>
</tr>
</table>
</div>
</body>
</html>
