003 File Manager
Current Path:
/usr/local/share/doc/db5/programmer_reference
usr
/
local
/
share
/
doc
/
db5
/
programmer_reference
/
📁
..
📄
BDB_Prog_Reference.pdf
(1.9 MB)
📄
am.html
(13.27 KB)
📄
am_close.html
(4.17 KB)
📄
am_conf.html
(13.76 KB)
📄
am_conf_logrec.html
(7.32 KB)
📄
am_conf_select.html
(24.85 KB)
📄
am_cursor.html
(36.58 KB)
📄
am_delete.html
(2.95 KB)
📄
am_foreign.html
(9.84 KB)
📄
am_get.html
(4.07 KB)
📄
am_misc.html
(6.3 KB)
📄
am_misc_bulk.html
(17.31 KB)
📄
am_misc_db_sql.html
(4.79 KB)
📄
am_misc_dbsizes.html
(4.06 KB)
📄
am_misc_diskspace.html
(11.57 KB)
📄
am_misc_error.html
(4.83 KB)
📄
am_misc_faq.html
(10.34 KB)
📄
am_misc_partial.html
(7.81 KB)
📄
am_misc_perm.html
(4.19 KB)
📄
am_misc_stability.html
(4.82 KB)
📄
am_misc_struct.html
(5.06 KB)
📄
am_misc_tune.html
(9.91 KB)
📄
am_opensub.html
(7.84 KB)
📄
am_partition.html
(17.19 KB)
📄
am_put.html
(4.68 KB)
📄
am_second.html
(14.76 KB)
📄
am_stat.html
(3.11 KB)
📄
am_sync.html
(3.63 KB)
📄
am_truncate.html
(2.54 KB)
📄
am_upgrade.html
(4.72 KB)
📄
am_verify.html
(4.77 KB)
📄
apprec.html
(8.14 KB)
📄
apprec_auto.html
(12.16 KB)
📄
apprec_config.html
(10 KB)
📄
apprec_def.html
(9.13 KB)
📄
arch.html
(11.09 KB)
📄
arch_apis.html
(10.27 KB)
📄
arch_bigpic.gif
(2.53 KB)
📄
arch_progmodel.html
(3.1 KB)
📄
arch_script.html
(4.39 KB)
📄
arch_smallpic.gif
(1.58 KB)
📄
arch_utilities.html
(8 KB)
📄
bdb_usenix.pdf
(79.81 KB)
📄
bt_conf.html
(29.94 KB)
📄
cam.html
(11.77 KB)
📄
cam_app.html
(16.91 KB)
📄
cam_fail.html
(7.77 KB)
📄
ch13s02.html
(4.19 KB)
📄
csharp.html
(7.48 KB)
📄
dumpload.html
(5.42 KB)
📄
dumpload_format.html
(6.58 KB)
📄
dumpload_text.html
(3.39 KB)
📄
embedded.html
(31.62 KB)
📄
env.html
(7.43 KB)
📄
env_create.html
(10.06 KB)
📄
env_db_config.html
(4.21 KB)
📄
env_encrypt.html
(10.19 KB)
📄
env_error.html
(4.77 KB)
📄
env_faq.html
(5.54 KB)
📄
env_naming.html
(15.54 KB)
📄
env_open.html
(4.95 KB)
📄
env_region.html
(8.11 KB)
📄
env_remote.html
(5.28 KB)
📄
env_security.html
(5.64 KB)
📄
env_size.html
(8.11 KB)
📄
ext.html
(7.13 KB)
📄
ext_perl.html
(3.84 KB)
📄
ext_php.html
(5.47 KB)
📄
general_am_conf.html
(21.43 KB)
📄
gettingStarted.css
(1.13 KB)
📄
group_membership.html
(20.37 KB)
📄
hash_conf.html
(6.96 KB)
📄
hash_usenix.pdf
(256.14 KB)
📄
heap_conf.html
(4.14 KB)
📄
index.html
(77.48 KB)
📄
intro.html
(9.57 KB)
📄
intro_dbis.html
(15.02 KB)
📄
intro_dbisnot.html
(13.49 KB)
📄
intro_distrib.html
(2.92 KB)
📄
intro_need.html
(5.06 KB)
📄
intro_products.html
(14.3 KB)
📄
intro_terrain.html
(19.43 KB)
📄
intro_what.html
(4.94 KB)
📄
intro_where.html
(3.75 KB)
📄
java.html
(7.62 KB)
📄
java_compat.html
(2.57 KB)
📄
java_faq.html
(7.5 KB)
📄
java_program.html
(6.69 KB)
📄
libtp_usenix.pdf
(243.14 KB)
📄
lock.html
(11.29 KB)
📄
lock_am_conv.html
(10.62 KB)
📄
lock_cam_conv.html
(4.95 KB)
📄
lock_config.html
(4.67 KB)
📄
lock_dead.html
(7.25 KB)
📄
lock_deaddbg.html
(10.32 KB)
📄
lock_max.html
(11.04 KB)
📄
lock_nondb.html
(4.94 KB)
📄
lock_notxn.html
(4.55 KB)
📄
lock_page.html
(5.71 KB)
📄
lock_stdmode.html
(5.27 KB)
📄
lock_timeout.html
(6.16 KB)
📄
lock_twopl.html
(4.48 KB)
📄
log.html
(7.08 KB)
📄
log_config.html
(5.06 KB)
📄
log_limits.html
(4.24 KB)
📄
magic.s5.be.txt
(3.54 KB)
📄
magic.s5.le.txt
(3.56 KB)
📄
magic.txt
(1.98 KB)
📄
moreinfo.html
(7.45 KB)
📄
mp.html
(8.86 KB)
📄
mp_config.html
(6.08 KB)
📄
mp_warm.html
(13.45 KB)
📄
preface.html
(5.1 KB)
📄
program.html
(7.21 KB)
📄
program_cache.html
(3.3 KB)
📄
program_compatible.html
(3.66 KB)
📄
program_copy.html
(7.35 KB)
📄
program_environ.html
(3.58 KB)
📄
program_errorret.html
(10.38 KB)
📄
program_faq.html
(4.58 KB)
📄
program_mt.html
(7.54 KB)
📄
program_namespace.html
(5.66 KB)
📄
program_perfmon.html
(32.07 KB)
📄
program_ram.html
(12.58 KB)
📄
program_runtime.html
(7.09 KB)
📄
program_scope.html
(9.8 KB)
📄
refs.html
(11.84 KB)
📄
rep.html
(16.57 KB)
📄
rep_app.html
(9.75 KB)
📄
rep_base_meth.html
(8.59 KB)
📄
rep_bulk.html
(4.01 KB)
📄
rep_clock_skew.html
(5.38 KB)
📄
rep_comm.html
(11.28 KB)
📄
rep_elect.html
(13.17 KB)
📄
rep_ex.html
(9.64 KB)
📄
rep_ex_chan.html
(8.52 KB)
📄
rep_ex_comm.html
(7.58 KB)
📄
rep_ex_rq.html
(5.52 KB)
📄
rep_faq.html
(9.2 KB)
📄
rep_filename.html
(7.7 KB)
📄
rep_id.html
(4.76 KB)
📄
rep_init.html
(5.14 KB)
📄
rep_lease.html
(18.32 KB)
📄
rep_mastersync.html
(11.24 KB)
📄
rep_mgr_ack.html
(8.5 KB)
📄
rep_mgr_meth.html
(11.06 KB)
📄
rep_mgrmulti.html
(10.28 KB)
📄
rep_newsite.html
(5.29 KB)
📄
rep_partition.html
(9.21 KB)
📄
rep_pri.html
(3.64 KB)
📄
rep_replicate.html
(18.8 KB)
📄
rep_ryw.html
(9.82 KB)
📄
rep_trans.html
(21.58 KB)
📄
rep_twosite.html
(6.76 KB)
📄
repmgr_channels.html
(13.34 KB)
📄
rq_conf.html
(18.29 KB)
📄
second.javas
(3.87 KB)
📄
sequence.html
(4.43 KB)
📄
solaris.txt
(5.62 KB)
📄
stl.html
(16.28 KB)
📄
stl_complex_rw.html
(19.31 KB)
📄
stl_container_specific.html
(9.04 KB)
📄
stl_db_advanced_usage.html
(9.68 KB)
📄
stl_db_usage.html
(13.27 KB)
📄
stl_efficienct_use.html
(11.87 KB)
📄
stl_examples.html
(8.24 KB)
📄
stl_known_issues.html
(4.54 KB)
📄
stl_memory_mgmt.html
(9.22 KB)
📄
stl_misc.html
(8.22 KB)
📄
stl_mt_usage.html
(9.06 KB)
📄
stl_persistence.html
(14.74 KB)
📄
stl_primitive_rw.html
(8.18 KB)
📄
stl_txn_usage.html
(4.88 KB)
📄
stl_usecase.html
(3.67 KB)
📄
tcl.html
(7.88 KB)
📄
tcl_error.html
(5.2 KB)
📄
tcl_faq.html
(4.89 KB)
📄
tcl_program.html
(3.78 KB)
📄
tcl_using.html
(4.43 KB)
📄
transapp.cs
(10.34 KB)
📄
transapp.html
(8.55 KB)
📄
transapp_admin.html
(4.8 KB)
📄
transapp_app.html
(25.08 KB)
📄
transapp_archival.html
(15.5 KB)
📄
transapp_atomicity.html
(5.46 KB)
📄
transapp_checkpoint.html
(6.18 KB)
📄
transapp_cursor.html
(6.79 KB)
📄
transapp_data_open.html
(7.52 KB)
📄
transapp_deadlock.html
(7.35 KB)
📄
transapp_env_open.html
(8.39 KB)
📄
transapp_fail.html
(6.8 KB)
📄
transapp_faq.html
(11.26 KB)
📄
transapp_filesys.html
(5.89 KB)
📄
transapp_hotfail.html
(10.54 KB)
📄
transapp_inc.html
(8.09 KB)
📄
transapp_journal.html
(4.72 KB)
📄
transapp_logfile.html
(5.3 KB)
📄
transapp_nested.html
(5.42 KB)
📄
transapp_put.html
(12.47 KB)
📄
transapp_read.html
(9.9 KB)
📄
transapp_reclimit.html
(12.6 KB)
📄
transapp_recovery.html
(8.74 KB)
📄
transapp_term.html
(6.02 KB)
📄
transapp_throughput.html
(9.06 KB)
📄
transapp_tune.html
(13.99 KB)
📄
transapp_why.html
(3.94 KB)
📄
txn.html
(8.63 KB)
📄
txn_config.html
(4.5 KB)
📄
txn_limits.html
(5.77 KB)
📄
witold.html
(745 B)
📄
writetest.cs
(2.26 KB)
📄
xa.html
(6.69 KB)
📄
xa_build.html
(19.12 KB)
📄
xa_faq.html
(7.27 KB)
📄
xa_xa_config.html
(8.1 KB)
📄
xa_xa_intro.html
(4.46 KB)
📄
xa_xa_restrict.html
(6.02 KB)
Editing: stl.html
<?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>Chapter 7. Standard Template Library API</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="index.html" title="Berkeley DB Programmer's Reference Guide" /> <link rel="prev" href="csharp.html" title="Chapter 6. C# API" /> <link rel="next" href="stl_usecase.html" title="Dbstl typical use cases" /> </head> <body> <div xmlns="" class="navheader"> <div class="libver"> <p>Library Version 11.2.5.3</p> </div> <table width="100%" summary="Navigation header"> <tr> <th colspan="3" align="center">Chapter 7. Standard Template Library API</th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="csharp.html">Prev</a> </td> <th width="60%" align="center"> </th> <td width="20%" align="right"> <a accesskey="n" href="stl_usecase.html">Next</a></td> </tr> </table> <hr /> </div> <div class="chapter" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h2 class="title"><a id="stl"></a>Chapter 7. Standard Template Library API</h2> </div> </div> </div> <div class="toc"> <p> <b>Table of Contents</b> </p> <dl> <dt> <span class="sect1"> <a href="stl.html#stl_intro">Dbstl introduction</a> </span> </dt> <dd> <dl> <dt> <span class="sect2"> <a href="stl.html#stl_intro_stdcompat">Standards compatible</a> </span> </dt> <dt> <span class="sect2"> <a href="stl.html#stl_intro_performance">Performance overhead</a> </span> </dt> <dt> <span class="sect2"> <a href="stl.html#stl_intro_portability">Portability</a> </span> </dt> </dl> </dd> <dt> <span class="sect1"> <a href="stl_usecase.html">Dbstl typical use cases</a> </span> </dt> <dt> <span class="sect1"> <a href="stl_examples.html">Dbstl examples</a> </span> </dt> <dt> <span class="sect1"> <a href="stl_db_usage.html">Berkeley DB configuration</a> </span> </dt> <dd> <dl> <dt> <span class="sect2"> <a href="stl_db_usage.html#idp51381760">Registering database and environment handles</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_db_usage.html#idp51405208">Truncate requirements</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_db_usage.html#idp51416888">Auto commit support</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_db_usage.html#idp51379224">Database and environment identity checks</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_db_usage.html#idp51415360">Products, constructors and configurations</a> </span> </dt> </dl> </dd> <dt> <span class="sect1"> <a href="stl_db_advanced_usage.html">Using advanced Berkeley DB features with dbstl</a> </span> </dt> <dd> <dl> <dt> <span class="sect2"> <a href="stl_db_advanced_usage.html#idp51421384">Using bulk retrieval iterators</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_db_advanced_usage.html#idp51410312">Using the DB_RMW flag</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_db_advanced_usage.html#idp51398048">Using secondary index database and secondary containers</a> </span> </dt> </dl> </dd> <dt> <span class="sect1"> <a href="stl_txn_usage.html">Using transactions in dbstl</a> </span> </dt> <dt> <span class="sect1"> <a href="stl_mt_usage.html">Using dbstl in multithreaded applications</a> </span> </dt> <dt> <span class="sect1"> <a href="stl_primitive_rw.html">Working with primitive types </a> </span> </dt> <dd> <dl> <dt> <span class="sect2"> <a href="stl_primitive_rw.html#idp51467888">Storing strings</a> </span> </dt> </dl> </dd> <dt> <span class="sect1"> <a href="stl_complex_rw.html">Store and Retrieve data or objects of complex types </a> </span> </dt> <dd> <dl> <dt> <span class="sect2"> <a href="stl_complex_rw.html#idp51458752">Storing varying length objects</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_complex_rw.html#idp51477944">Storing arbitrary sequences</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_complex_rw.html#idp51524696">Notes</a> </span> </dt> </dl> </dd> <dt> <span class="sect1"> <a href="stl_persistence.html">Dbstl persistence</a> </span> </dt> <dd> <dl> <dt> <span class="sect2"> <a href="stl_persistence.html#directdbget">Direct database get</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_persistence.html#chg_persistence">Change persistence</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_persistence.html#obj_life_persistence">Object life time and persistence </a> </span> </dt> </dl> </dd> <dt> <span class="sect1"> <a href="stl_container_specific.html">Dbstl container specific notes</a> </span> </dt> <dd> <dl> <dt> <span class="sect2"> <a href="stl_container_specific.html#idp51492808">db_vector specific notes</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_container_specific.html#idp51561456">Associative container specific notes</a> </span> </dt> </dl> </dd> <dt> <span class="sect1"> <a href="stl_efficienct_use.html">Using dbstl efficiently</a> </span> </dt> <dd> <dl> <dt> <span class="sect2"> <a href="stl_efficienct_use.html#idp51530568">Using iterators efficiently</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_efficienct_use.html#idp51530352">Using containers efficiently</a> </span> </dt> </dl> </dd> <dt> <span class="sect1"> <a href="stl_memory_mgmt.html">Dbstl memory management</a> </span> </dt> <dd> <dl> <dt> <span class="sect2"> <a href="stl_memory_mgmt.html#idp51564672">Freeing memory</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_memory_mgmt.html#idp51569240">Type specific notes</a> </span> </dt> </dl> </dd> <dt> <span class="sect1"> <a href="stl_misc.html">Dbstl miscellaneous notes</a> </span> </dt> <dd> <dl> <dt> <span class="sect2"> <a href="stl_misc.html#idp51587208">Special notes about trivial methods</a> </span> </dt> <dt> <span class="sect2"> <a href="stl_misc.html#idp51603304">Using correct container and iterator public types</a> </span> </dt> </dl> </dd> <dt> <span class="sect1"> <a href="stl_known_issues.html">Dbstl known issues</a> </span> </dt> </dl> </div> <div class="sect1" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h2 class="title" style="clear: both"><a id="stl_intro"></a>Dbstl introduction</h2> </div> </div> </div> <div class="toc"> <dl> <dt> <span class="sect2"> <a href="stl.html#stl_intro_stdcompat">Standards compatible</a> </span> </dt> <dt> <span class="sect2"> <a href="stl.html#stl_intro_performance">Performance overhead</a> </span> </dt> <dt> <span class="sect2"> <a href="stl.html#stl_intro_portability">Portability</a> </span> </dt> </dl> </div> <p> Dbstl is a C++ STL style API that provides for Berkeley DB usage. It allows for the storage and retrieval of data/objects of any type using Berkeley DB databases, but with an interface that mimics that of C++ STL containers. Dbstl provides access to all of the functionality of Berkeley DB available via this STL-style API. </p> <p> With proper configuration, dbstl is able to store/retrieve any complex data types. There is no need to perform repetitive marshalling and unmarshalling of data. Dbstl also properly manages the life-cycle of all Berkeley DB structures and objects. All example methods referred to in this chapter can be found in the StlAdvancedFeaturesExample class in the $DbSrc/examples_stl/StlAdvancedFeatures.cpp file, and you can build the example in $DbSrc/build_unix directory like this: make exstl_advancedfeatures, where DbSrc is the source directory for Berkeley DB. </p> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h3 class="title"><a id="stl_intro_stdcompat"></a>Standards compatible</h3> </div> </div> </div> <p> Dbstl is composed of many container and iterator class templates. These containers and iterators correspond exactly to each container and iterator available in the C++ STL API, including identical sets of methods. This allows existing algorithms, functions and container-adapters for C++ STL to use dbstl containers through its standard iterators. This means that existing STL code can manipulate Berkeley DB databases. As a result, existing C++ STL code can very easily use dbstl to gain persistence and transaction guarantees. </p> </div> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h3 class="title"><a id="stl_intro_performance"></a>Performance overhead</h3> </div> </div> </div> <p> Because dbstl uses C++ template technologies, its performance overhead is minimal. </p> <p> The dbstl API performs almost equally to the C API, as measured by two different implementations of the TPC-B benchmark: <code class="literal">ex_tpcb</code> and <code class="literal">exstl_tpcb</code>. </p> </div> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h3 class="title"><a id="stl_intro_portability"></a>Portability</h3> </div> </div> </div> <p> The degree to which dbstl is portable to a new platform is determined by whether Berkeley DB is available on the platform, as well as whether an appropriate C++ compiler is available on the platform. </p> <p> For information on porting Berkeley DB to new platforms, see the <em class="citetitle">Berkeley DB Porting Guide</em>. </p> <p> Almost all the advanced C++ template features are used in dbstl, including: </p> <div class="itemizedlist"> <ul type="disc"> <li> <p> member function templates </p> </li> <li> <p> member function template overloads </p> </li> <li> <p> partial specialization </p> </li> <li> <p> default template parameters. </p> </li> </ul> </div> <p> For this reason, you need a standards-compatible C++ compiler to build dbstl. As of this writing, the following compilers are known to build dbstl successfully: </p> <div class="itemizedlist"> <ul type="disc"> <li> <p> MSVC8 </p> </li> <li> <p> gcc3.4.4 and above </p> </li> <li> <p> Intel C++ 9 and above </p> </li> </ul> </div> <p> For *nix platforms, if you can successfully configure your Berkeley DB build script with <code class="literal">--enable-stl</code>, then you should be able to successfully build dbstl library and application code using it. </p> <p> Besides its own test suite, dbstl has also been tested against, and passes, the following test suites: </p> <div class="itemizedlist"> <ul type="disc"> <li> <p> MS STL test suite </p> </li> <li> <p> SGI STL test suite </p> </li> </ul> </div> </div> </div> </div> <div class="navfooter"> <hr /> <table width="100%" summary="Navigation footer"> <tr> <td width="40%" align="left"><a accesskey="p" href="csharp.html">Prev</a> </td> <td width="20%" align="center"> </td> <td width="40%" align="right"> <a accesskey="n" href="stl_usecase.html">Next</a></td> </tr> <tr> <td width="40%" align="left" valign="top">Chapter 6. C# API </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> <td width="40%" align="right" valign="top"> Dbstl typical use cases</td> </tr> </table> </div> </body> </html>
Upload File
Create Folder
