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_primitive_rw.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>Working with primitive types</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="stl.html" title="ChapterΒ 7.Β Standard Template Library API" /> <link rel="prev" href="stl_mt_usage.html" title="Using dbstl in multithreaded applications" /> <link rel="next" href="stl_complex_rw.html" title="Store and Retrieve data or objects of complex types" /> </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">Working with primitive types </th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="stl_mt_usage.html">Prev</a>Β </td> <th width="60%" align="center">ChapterΒ 7.Β Standard Template Library API</th> <td width="20%" align="right">Β <a accesskey="n" href="stl_complex_rw.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="stl_primitive_rw"></a>Working with primitive types </h2> </div> </div> </div> <div class="toc"> <dl> <dt> <span class="sect2"> <a href="stl_primitive_rw.html#idp51467888">Storing strings</a> </span> </dt> </dl> </div> <p> To store simple primitive types such as <code class="literal">int</code>, <code class="literal">long</code>, <code class="literal">double</code>, and so forth, an additional type parameter for the container class templates is needed. For example, to store an <code class="literal">int</code> in a <code class="classname">db_vector</code>, use this container class: </p> <pre class="programlisting">db_vector<int, ElementHolder<int> >;</pre> <p> To map integers to doubles, use this: </p> <pre class="programlisting">db_map<int, double, ElementHolder<double> >;</pre> <p> To store a <code class="literal">char*</code> string with <code class="literal">long</code> keys, use this: </p> <pre class="programlisting">db_map<long, char*, ElementHolder<char*> >;</pre> <p> Use this for <code class="literal">const char*</code> strings: </p> <pre class="programlisting">db_map<long, const char*, ElementHolder<const char*> >;</pre> <p> To map one const string to another, use this type: </p> <pre class="programlisting">db_map<const char*, const char*, ElementHolder<const char*> >;</pre> <p> The <code class="methodname">StlAdvancedFeaturesExample::primitive()</code> method demonstrates more of these examples. </p> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h3 class="title"><a id="idp51467888"></a>Storing strings</h3> </div> </div> </div> <p> For <code class="literal">char*</code> and <code class="literal">wchar_t*</code> strings, <code class="methodname">_DB_STL_StoreElement()</code> must be called following partial or total modifications before iterator movement, <code class="literal">container::operator[]</code> or <code class="literal">iterator::operator*/-></code> calls. Without the <code class="methodname">_DB_STL_StoreElement()</code> call, the modified change will be lost. If storing an new value like this: </p> <pre class="programlisting">*iterator = new_char_star_string;</pre> <p> the call to <code class="methodname">_DB_STL_StoreElement()</code> is not needed. </p> <p> Note that passing a NULL pointer to a container of <code class="literal">char*</code> type or passing a <code class="classname">std::string</code> with no contents at all will insert an empty string of zero length into the database. </p> <p> The string returned from a container will not live beyond the next iterator movement call, <code class="literal">container::operator[]</code> or <code class="literal">iterator::operator*/-></code> call. </p> <p> A <span class="bold"><strong>db_map::value_type::second_type</strong></span> or <span class="bold"><strong>db_map::datatype_wrap</strong></span> should be used to hold a reference to a <code class="literal">container::operator[]</code> return value. Then the reference should be used for repeated references to that value. The *iterator is of type <code class="literal">ElementHolder<char *></code>, which can be automatically converted to a <code class="literal">char *</code> pointer using its type conversion operator. Wherever an auto conversion is done by the compiler, the conversion operator of <code class="literal">ElementHolder<T></code> is called. This avoids almost all explicit conversions, except for two use cases: </p> <div class="orderedlist"> <ol type="1"> <li> <p> The *iterator is used as a "..." parameter like this: </p> <pre class="programlisting">printf("this is the special case %s", *iterator);</pre> <p> This compiles but causes errors. Instead, an explicit cast should be used: </p> <pre class="programlisting">printf("this is the special case %s", (char *)*iterator);</pre> </li> <li> <p> For some old compilers, such as gcc3.4.6, the *iterator cannot be used with the ternary <code class="literal">?</code> operator, like this: </p> <pre class="programlisting">expr ? *iterator : var</pre> <p> Even when <span class="bold"><strong>var</strong></span> is the same type as the iterator's <code class="literal">value_type</code>, the compiler fails to perform an auto conversion. </p> </li> </ol> </div> <p> When using <code class="classname">std::string</code> or <code class="classname">std::wstring</code> as the data type for dbstl containers β that is, <code class="classname">db_vector<string></code>, and <code class="classname">db_map<string, wstring></code> β the string's content rather than the string object itself is stored in order to maintain persistence. </p> <p> You can find example code demonstrating string storage in the <code class="methodname">StlAdvancedFeaturesExample::char_star_string_storage()</code> and <code class="methodname">StlAdvancedFeaturesExample::storing_std_strings()</code> methods. </p> </div> </div> <div class="navfooter"> <hr /> <table width="100%" summary="Navigation footer"> <tr> <td width="40%" align="left"><a accesskey="p" href="stl_mt_usage.html">Prev</a>Β </td> <td width="20%" align="center"> <a accesskey="u" href="stl.html">Up</a> </td> <td width="40%" align="right">Β <a accesskey="n" href="stl_complex_rw.html">Next</a></td> </tr> <tr> <td width="40%" align="left" valign="top">Using dbstl in multithreaded applicationsΒ </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> <td width="40%" align="right" valign="top">Β Store and Retrieve data or objects of complex types </td> </tr> </table> </div> </body> </html>
Upload File
Create Folder