libdb/docs/api_reference/STL/stldb_setinsert.html
2011-12-19 19:07:10 -05:00

281 lines
9.8 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?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>insert</title>
<link rel="stylesheet" href="apiReference.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
<link rel="start" href="index.html" title="Berkeley DB C++ Standard Template Library API Reference" />
<link rel="up" href="db_set.html" title="Chapter 7.  Db_set" />
<link rel="prev" href="stldb_setdstr_db_set.html" title="~db_set" />
<link rel="next" href="stldb_setoperator_assign.html" title="operator=" />
</head>
<body>
<div xmlns="" class="navheader">
<div class="libver">
<p>Library Version 11.2.5.2</p>
</div>
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">insert</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="stldb_setdstr_db_set.html">Prev</a> </td>
<th width="60%" align="center">Chapter 7. 
Db_set </th>
<td width="20%" align="right"> <a accesskey="n" href="stldb_setoperator_assign.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="stldb_setinsert"></a>insert</h2>
</div>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="stldb_setinsert_details"></a>Function Details</h3>
</div>
</div>
</div>
<pre class="programlisting">
insert(const value_type &amp;x)
</pre>
<p>Insert a single key/data pair if the key is not in the container. </p>
<div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a id="id3606129"></a>Parameters</h4>
</div>
</div>
</div>
<div class="sect4" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h5 class="title"><a id="id3606299"></a>x</h5>
</div>
</div>
</div>
<p>The key/data pair to insert. </p>
</div>
</div>
<div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a id="id3606134"></a>Return Value</h4>
</div>
</div>
</div>
<p>A pair P, if insert OK, i.e. the inserted key wasn't in the container, P.first will be the iterator positioned on the inserted key/data pair, and P.second is true; otherwise P.first is an invalid iterator equal to that returned by <a class="link" href="stldb_mapend.html" title="end">end()</a>
and P.second is false. </p>
</div>
<pre class="programlisting">
void insert(const_iterator &amp;first,
const_iterator &amp;last)
</pre>
<p>Range insertion. </p>
<p>Insert a range [first, last) of key/data pairs into this container. </p>
<div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a id="id3606346"></a>Parameters</h4>
</div>
</div>
</div>
<div class="sect4" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h5 class="title"><a id="id3606349"></a>last</h5>
</div>
</div>
</div>
<p>The open boundary of the range. </p>
</div>
<div class="sect4" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h5 class="title"><a id="id3606363"></a>first</h5>
</div>
</div>
</div>
<p>The closed boundary of the range. </p>
</div>
</div>
<pre class="programlisting">
void insert(iterator &amp;first,
iterator &amp;last)
</pre>
<p>Range insertion. </p>
<p>Insert a range [first, last) of key/data pairs into this container. </p>
<div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a id="id3606369"></a>Parameters</h4>
</div>
</div>
</div>
<div class="sect4" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h5 class="title"><a id="id3606372"></a>last</h5>
</div>
</div>
</div>
<p>The open boundary of the range. </p>
</div>
<div class="sect4" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h5 class="title"><a id="id3606386"></a>first</h5>
</div>
</div>
</div>
<p>The closed boundary of the range. </p>
</div>
</div>
<pre class="programlisting">
iterator insert(iterator position,
const value_type &amp;x)
</pre>
<p>Insert with hint position. </p>
<p>We ignore the hint position because Berkeley DB knows better where to insert. </p>
<div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a id="id3606393"></a>Parameters</h4>
</div>
</div>
</div>
<div class="sect4" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h5 class="title"><a id="id3606396"></a>position</h5>
</div>
</div>
</div>
<p>The hint position. </p>
</div>
<div class="sect4" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h5 class="title"><a id="id3606410"></a>x</h5>
</div>
</div>
</div>
<p>The key/data pair to insert. </p>
</div>
</div>
<div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a id="id3606280"></a>Return Value</h4>
</div>
</div>
</div>
<p>The iterator positioned on the inserted key/data pair, or an invalid iterator if the key was already in the container. </p>
</div>
<pre class="programlisting">
void insert(InputIterator first,
InputIterator last)
</pre>
<p>Range insertion. </p>
<p>Insert a range [first, last) of key/data pairs into this container. </p>
<div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a id="id3606424"></a>Parameters</h4>
</div>
</div>
</div>
<div class="sect4" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h5 class="title"><a id="id3606427"></a>last</h5>
</div>
</div>
</div>
<p>The open boundary of the range. </p>
</div>
<div class="sect4" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h5 class="title"><a id="id3606441"></a>first</h5>
</div>
</div>
</div>
<p>The closed boundary of the range. </p>
</div>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="id3606144"></a>Group: Insert Functions</h3>
</div>
</div>
</div>
<div class="simplesect" lang="en" xml:lang="en">
<div class="titlepage"></div>
<p><a class="ulink" href="http://www.cplusplus.com/reference/stl/set/insert/" target="_top">http://www.cplusplus.com/reference/stl/set/insert/</a> </p>
</div>
<p>
</p>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="id3606139"></a>Class</h3>
</div>
</div>
</div>
<p>
<a class="link" href="db_set.html" title="Chapter 7.  Db_set">db_set</a>
</p>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="stldb_setdstr_db_set.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="db_set.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="stldb_setoperator_assign.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">~db_set </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> operator=</td>
</tr>
</table>
</div>
</body>
</html>