File Manager

003 File Manager

Current Path: /usr/local/share/doc/db5/gsg/CXX

usr / local / share / doc / db5 / gsg / CXX /

📁 ..
📄 BerkeleyDB-Core-Cxx-GSG.pdf(402.24 KB)
📄 CoreCursorUsage.html(11.1 KB)
📄 CoreDBAdmin.html(5.22 KB)
📄 CoreDbCXXUsage.html(7 KB)
📄 CoreEnvUsage.html(6.97 KB)
📄 Cursors.html(5.93 KB)
📄 DBEntry.html(6.46 KB)
📄 DBOpenFlags.html(4.32 KB)
📄 DbCXXUsage.html(20.83 KB)
📄 DeleteEntryWCursor.html(3.69 KB)
📄 Positioning.html(19.87 KB)
📄 PutEntryWCursor.html(8.37 KB)
📄 ReplacingEntryWCursor.html(4.94 KB)
📄 accessmethods.html(12.5 KB)
📄 btree.html(21.41 KB)
📄 cachesize.html(4.56 KB)
📄 concepts.html(8.63 KB)
📄 coreExceptions.html(3.78 KB)
📄 coredbclose.html(4.33 KB)
📄 coreindexusage.html(22.31 KB)
📄 databaseLimits.html(3.77 KB)
📄 databases.html(6.07 KB)
📄 dbErrorReporting.html(7.36 KB)
📄 dbconfig.html(17.69 KB)
📄 environments.html(6.31 KB)
📄 gettingStarted.css(1.13 KB)
📄 gettingit.html(3.45 KB)
📄 index.html(16.66 KB)
📄 indexes.html(12.17 KB)
📄 introduction.html(9.77 KB)
📄 joins.html(10.09 KB)
📄 keyCreator.html(10.23 KB)
📄 moreinfo.html(6.97 KB)
📄 preface.html(6.36 KB)
📄 readSecondary.html(4.95 KB)
📄 returns.html(3.52 KB)
📄 secondaryCursor.html(5.34 KB)
📄 secondaryDelete.html(5.79 KB)
📄 usingDbt.html(15.18 KB)

Editing: CoreEnvUsage.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>Managing Databases in Environments</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="databases.html" title="Chapter 2. Databases" />
    <link rel="prev" href="dbErrorReporting.html" title="Error Reporting Functions" />
    <link rel="next" href="CoreDbCXXUsage.html" title="Database Example" />
  </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">Managing Databases in Environments</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="dbErrorReporting.html">Prev</a> </td>
          <th width="60%" align="center">Chapter 2. Databases</th>
          <td width="20%" align="right"> <a accesskey="n" href="CoreDbCXXUsage.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="CoreEnvUsage"></a>Managing Databases in Environments</h2>
          </div>
        </div>
      </div>
      <p>
            In 
            <span>
            <a class="xref" href="environments.html" title="Environments">Environments</a>, 
            </span>
            
            
            we introduced
        environments. While environments are not used in the example built in this book,
        they are so commonly used for a wide class of DB applications that it is 
        necessary to show their basic usage, if only from a completeness perspective.
    </p>
      <p>
        To use an environment, you must first
            
        open it. At open time, you must identify the directory in 
        which it resides. This directory must exist prior to the open attempt. 
        You can also identify open properties, such as whether the environment can be
        created if it does not already exist.
    </p>
      <p>
        You will also need to initialize the in-memory cache when you open your environment.
    </p>
      <p>
        For example, to 
            <span>create an environment handle and</span>
        open an environment:
    </p>
      <a id="cxx_env1"></a>
      <pre class="programlisting">#include &lt;db_cxx.h&gt;
...
u_int32_t env_flags = DB_CREATE |     // If the environment does not
                                      // exist, create it.
                      DB_INIT_MPOOL; // Initialize the in-memory cache.

std::string envHome("/export1/testEnv");
DbEnv myEnv(0);

try {
    myEnv.open(envHome.c_str(), env_flags, 0);
} catch(DbException &amp;e) {
    std::cerr &lt;&lt; "Error opening database environment: "
              &lt;&lt; envHome &lt;&lt; std::endl;
    std::cerr &lt;&lt; e.what() &lt;&lt; std::endl;
    exit( -1 );
} catch(std::exception &amp;e) {
    std::cerr &lt;&lt; "Error opening database environment: "
              &lt;&lt; envHome &lt;&lt; std::endl;
    std::cerr &lt;&lt; e.what() &lt;&lt; std::endl;
    exit( -1 );
} </pre>
      <p>
        Once an environment is opened, you can open databases in it. Note that by default databases
        are stored in the environment's home directory, or relative to that directory if you
        provide any sort of a path in the database's file name:
    </p>
      <a id="cxx_env2"></a>
      <pre class="programlisting">#include &lt;db_cxx.h&gt;
...
u_int32_t env_flags = DB_CREATE |  // If the environment does not
                                  // exist, create it.
                      DB_INIT_MPOOL; // Initialize the in-memory cache.
std::string envHome("/export1/testEnv");
                    
<strong class="userinput"><code>u_int32_t db_flags = DB_CREATE;   // If the database does not
                                  // exist, create it.</code></strong>
<strong class="userinput"><code>std::string dbName("mydb.db");</code></strong>
DbEnv myEnv(0);
<strong class="userinput"><code>Db *myDb;</code></strong>

try {
    myEnv.open(envHome.c_str(), env_flags, 0);
    <strong class="userinput"><code>myDb = new Db(&amp;myEnv, 0);
    myDb-&gt;open(NULL,
               dbName.c_str(),
               NULL,
               DB_BTREE,
               db_flags,
               0);</code></strong>
} catch(DbException &amp;e) {
    std::cerr &lt;&lt; "Error opening database environment: "
              &lt;&lt; envHome 
              &lt;&lt; " and database "
              &lt;&lt; dbName &lt;&lt; std::endl;
    std::cerr &lt;&lt; e.what() &lt;&lt; std::endl;
    exit( -1 );
} catch(std::exception &amp;e) {
    std::cerr &lt;&lt; "Error opening database environment: "
              &lt;&lt; envHome 
              &lt;&lt; " and database "
              &lt;&lt; dbName &lt;&lt; std::endl;
    std::cerr &lt;&lt; e.what() &lt;&lt; std::endl;
    exit( -1 );
} </pre>
      <p>
        When you are done with an environment, you must close it. It is recommended that before closing an environment,
        you close any open databases.
    </p>
      <a id="cxx_env3"></a>
      <pre class="programlisting">try {
    if (myDb != NULL) {
        myDb-&gt;close(0);
    }
    myEnv.close(0);
    
} catch(DbException &amp;e) {
    std::cerr &lt;&lt; "Error closing database environment: "
              &lt;&lt; envHome 
              &lt;&lt; " or database "
              &lt;&lt; dbName &lt;&lt; std::endl;
    std::cerr &lt;&lt; e.what() &lt;&lt; std::endl;
    exit( -1 );
} catch(std::exception &amp;e) {
    std::cerr &lt;&lt; "Error closing database environment: "
              &lt;&lt; envHome 
              &lt;&lt; " or database "
              &lt;&lt; dbName &lt;&lt; std::endl;
    std::cerr &lt;&lt; e.what() &lt;&lt; std::endl;
    exit( -1 );
} </pre>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="dbErrorReporting.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="databases.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="CoreDbCXXUsage.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">Error Reporting Functions </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> Database Example</td>
        </tr>
      </table>
    </div>
  </body>
</html>

003 File Manager

Editing: CoreEnvUsage.html

Upload File

Create Folder