exceptionnotes.htm

The goal of this library is to make ODBC recordsets look just like an STL container. As a user, you

<p><font size="2" face="Courier New">//--------------stuff below
here is for our internal use for now
--------------------------------//</font></p>

<p>&nbsp;</p>

<p><a name="1"></a><font size="2" face="Courier New"><i>(
Operations labelled with * are guaranteed to return normally if
all </i></font><a
href="http://www.stlport.org/doc/exception_safety.html#basic_requirements"><font
size="2" face="Courier New"><i>basic requirements</i></font></a><font
size="2" face="Courier New"><i> have been met) </i></font></p>

<ul>
    <li><font size="4" face="Times New Roman"><tt>all </tt></font><font
        size="2" face="Courier New"><tt>BoundIO </tt>public
        member functions</font></li>
    <li><font size="4" face="Times New Roman"><tt>all </tt></font><font
        size="2" face="Courier New"><tt>BoundIOs </tt>public
        member functions plus the operations from map&lt;string,
        BoundIO&gt; </font><font size="3" face="Courier New">which
        provide the strong guarantee</font></li>
    <li><font size="4" face="Times New Roman"><tt>all </tt></font><font
        size="2" face="Courier New"><tt>CountedPtr&lt;T&gt;
        public </tt>member functions</font></li>
    <li><font size="4" face="Times New Roman"><tt>all </tt></font><font
        size="2" face="Courier New">DB_iterator&lt;DataObj,
        ParamObj&gt; public member functions (all iterator
        operations, including all members in the derived classes
        of DB_iterator&lt;DataObj, ParamObj&gt;, are guaranteed
        not to throw if the </font><font size="3"
        face="Courier New"><tt>IOHandler </tt></font><font
        size="2" face="Courier New">for that iterator always
        returns dtl_ios_base::SUPPRESS_ERROR, see section on
        IOHandler for further explanation. All iterator
        guarantees assume that any IOHandler returns dtl_ios_base::THROW_EXCEPTION
        as this worst case scenario defines what formal
        guarantees we may have overall on iterators)</font></li>
</ul>

<ul>
    <li><font size="2" face="Courier New"><tt>DBView&lt;DataObj,
        ParamObj&gt;::select_iterator </tt>- all strong
        guaranteed methods inherited from DB_iterator&lt;DataObj,
        ParamObj&gt; and member functions: </font><ul>
            <li><font size="2" face="Courier New"><tt>operator==(const
                DBView&lt;DataObj&gt;::select_iterator &amp;other)</tt></font><a
                href="http://www.stlport.org/doc/exception_safety.html#1"><font
                size="3">* </font></a></li>
            <li><font size="2" face="Courier New"><tt>operator!=(const
                DBView&lt;DataObj&gt;::select_iterator &amp;other)</tt></font><a
                href="http://www.stlport.org/doc/exception_safety.html#1"><font
                size="3">* </font></a></li>
            <li><font size="2" face="Courier New"><tt>operator*()</tt></font><a
                href="http://www.stlport.org/doc/exception_safety.html#1"><font
                size="3">* </font></a></li>
            <li><font size="2" face="Courier New"><tt>operator-&gt;()</tt></font><a
                href="http://www.stlport.org/doc/exception_safety.html#1"><font
                size="3">* </font></a></li>
            <li><font size="2" face="Courier New"><tt>operator++()</tt></font><a
                href="http://www.stlport.org/doc/exception_safety.html#1"><font
                size="3">* </font></a></li>
            <li><font size="2" face="Courier New">swap(DBView&lt;DataObj,
                ParamObj&gt;::select_iterator &amp;other)</font></li>
            <li><font size="2" face="Courier New">operator=(const
                <tt>DBView&lt;DataObj, ParamObj&gt;::select_iterator
                &amp;other)</tt></font></li>
        </ul>
    </li>
    <li><font size="2" face="Courier New"><tt>DBView&lt;DataObj,
        ParamObj&gt;::insert_iterator </tt>- all strong
        guaranteed methods inherited from DB_iterator&lt;DataObj,
        ParamObj&gt; and member functions: </font><ul>
            <li><font size="2" face="Courier New"><tt>operator=(const
                DataObj &amp;data)</tt></font><a
                href="http://www.stlport.org/doc/exception_safety.html#1"><font
                size="3">* </font></a></li>
            <li><font size="2" face="Courier New"><tt>operator++()
                </tt></font><a
                href="http://www.stlport.org/doc/exception_safety.html#1"><font
                size="3">* </font></a></li>
            <li><font size="2" face="Courier New">operator=(<tt>DBView&lt;DataObj,
                ParamObj&gt;::insert_iterator &amp;other)</tt></font></li>
            <li><font size="2" face="Courier New">operator*()</font></li>
            <li><font size="2" face="Courier New">swap(DBView&lt;DataObj,
                ParamObj&gt;::insert_iterator &amp;other)</font></li>
        </ul>
    </li>
    <li><font size="2" face="Courier New"><tt>DBView&lt;DataObj,
        ParamObj&gt;::update_iterator </tt>- all strong
        guaranteed methods inherited from DB_iterator&lt;DataObj,
        ParamObj&gt; and member functions: </font><ul>
            <li><font size="2" face="Courier New"><tt>operator=(const
                DataObj &amp;data)</tt></font><a
                href="http://www.stlport.org/doc/exception_safety.html#1"><font
                size="3">* </font></a></li>
            <li><font size="2" face="Courier New"><tt>operator++()</tt></font><a
                href="http://www.stlport.org/doc/exception_safety.html#1"><font
                size="3">* </font></a></li>
            <li><font size="2" face="Courier New">operator=(<tt>DBView&lt;DataObj,
                ParamObj&gt;::update_iterator &amp;other)</tt></font></li>
            <li><font size="2" face="Courier New">operator*()</font></li>
            <li><font size="2" face="Courier New">swap(DBView&lt;DataObj,
                ParamObj&gt;::update_iterator &amp;other)</font></li>
        </ul>
    </li>
    <li><font size="2" face="Courier New"><tt>DBView&lt;DataObj,
        ParamObj&gt;::delete_iterator </tt>- </font><font
        size="3">all strong guaranteed methods inherited from</font><font
        size="3" face="Courier New"> </font><font size="2"
        face="Courier New">DB_iterator&lt;DataObj, ParamObj&gt; </font><font
        size="3">and member functions: </font><ul>
            <li><font size="2" face="Courier New"><tt>operator=(const
                DataObj &amp;data)</tt></font><a
                href="http://www.stlport.org/doc/exception_safety.html#1"><font
                size="3">* </font></a></li>
            <li><font size="2" face="Courier New"><tt>operator++()</tt></font><a
                href="http://www.stlport.org/doc/exception_safety.html#1"><font
                size="3">* </font></a></li>
            <li><font size="2" face="Courier New">operator=(<tt>DBView&lt;DataObj,
                ParamObj&gt;::delete_iterator &amp;other)</tt></font></li>
            <li><font size="2" face="Courier New">operator*()</font></li>
            <li><font size="2" face="Courier New">swap(DBView&lt;DataObj,
                ParamObj&gt;::delete_iterator &amp;other)</font></li>
        </ul>
    </li>
    <li><font size="2" face="Courier New">DBConnection </font><font
        size="3">public member functions</font><font size="3"
        face="Courier New"> </font><font size="4"
        face="Times New Roman"><tt>and all methods inherited from
        </tt></font><font size="3" face="Courier New"><tt>ValidatedObject</tt></font><font
        size="4" face="Times New Roman"><tt>:</tt></font><font
        size="2" face="Courier New"> </font><ul>
            <li><font size="2" face="Courier New"><tt>CommitAll()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>Connect()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>Connect(const
                string &amp;DSN)</tt></font></li>
            <li><font size="2" face="Courier New"><tt>GetDefaultConnection()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>GetHDBC()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>GetHENV()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>RollbackAll()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>SetAutoCommit(bool
                auto_commit)</tt></font></li>
            <li><font size="2" face="Courier New"><tt>GetAutoCommit()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>swap(DBConnection
                &amp;other)</tt></font></li>
        </ul>
    </li>
    <li><font size="4" face="Times New Roman"><tt>all </tt></font><font
        size="2" face="Courier New"><tt>DBEnvironment </tt></font><font
        size="4" face="Times New Roman"><tt>public member
        functions</tt></font></li>
    <li><font size="4" face="Times New Roman"><tt>all public
        member functions of </tt></font><font size="2"
        face="Courier New">RootException </font><font size="3"
        face="Courier New">and derived classes and all methods
        inherited from </font><font size="2" face="Courier New">std::exception
        </font><font size="3" face="Courier New">which carry the
        strong guarantee</font></li>
    <li><font size="2" face="Courier New">DBIndex&lt;View&gt; </font><font
        size="4" face="Times New Roman"><tt>public member
        functions:</tt></font><ul>
            <li><font size="2" face="Courier New"><tt>begin()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>empty()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>end()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>equal_range(const
                DataObj &amp;data)</tt></font></li>
            <li><font size="2" face="Courier New"><tt>template&lt;class
                DataField&gt; find(const DataField &amp;df)</tt></font></li>
            <li><font size="2" face="Courier New"><tt>find(const
                DataObj &amp;data)</tt></font></li>
            <li><font size="2" face="Courier New"><tt>GetIndexFields()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>insert(const
                DataObj &amp;data)</tt></font></li>
            <li><font size="2" face="Courier New"><tt>erase(const
                DataObj &amp;data)</tt></font></li>
            <li><font size="2" face="Courier New"><tt>IsUnique()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>max_size()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>size()</tt></font></li>
            <li><font size="2" face="Courier New"><tt>swap(const
                DBIndex&lt;View&gt; &amp;idx)</tt></font></li>
        </ul>
    </li>
</ul>

<ul>
    <li><font size="2" face="Courier New"><tt>DBStmt </tt></font><font
        size="4" face="Times New Roman"><tt>public member
        functions and all methods inherited from </tt></font><font
        size="3" face="Courier New"><tt>ValidatedObject</tt></font><font
        size="4" face="Times New Roman"><tt>:</tt></font><ul>
            <li><font size="2" face="Courier New">GetConnection()</font></li>
            <li><font size="2" face="Courier New">GetHSTMT()</font></li>
            <li><font size="2" face="Courier New">GetQuery()</font></li>
            <li><font size="2" face="Courier New">Initialize()</font></li>
            <li><font size="2" face="Courier New">IsAllocated()</font></li>
            <li><font size="2" face="Courier New">IsReady()</font></li>
            <li><font size="2" face="Courier New">SetConnection(const
                DBConnection &amp;conn)</font></li>
            <li><font size="2" face="Courier New">swap(DBStmt
                &amp;other)</font></li>
            <li><font size="2" face="Courier New">valid()</font></li>
        </ul>
    </li>
    <li><font size="2" face="Courier New">DBView&lt;DataObj,
        ParamObj&gt; </font><font size="4" face="Times New Roman"><tt>public
        member functions:</tt></font><ul>
            <li><font size="2" face="Courier New">begin()</font></li>
            <li><font size="2" face="Courier New">end()</font></li>
            <li><font size="2" face="Courier New">BuildQry(SQLQueryType
                qryType)</font></li>
            <li><font size="2" face="Courier New">GetBCA()</font></li>
            <li><font size="2" face="Courier New">GetBoundParamCount()</font></li>
            <li><font size="2" face="Courier New">GetBPA()</font></li>
            <li><font size="2" face="Courier New">GetInsVal()</font></li>
            <li><font size="2" face="Courier New">GetSelVal()</font></li>
            <li><font size="2" face="Courier New">GetColNames()</font></li>
            <li><font size="2" face="Courier New">GetColumnCount()</font></li>
            <li><font size="2" face="Courier New">GetConnection()</font></li>
            <li><font size="2" face="Courier New">GetPostfixClause()</font></li>
            <li><font size="2" face="Courier New">GetTableNames()</font></li>
            <li><font size="2" face="Courier New">operator=(const
                DBView&lt;DataObj, ParamObj&gt; &amp;other)</font></li>
            <li><font size="2" face="Courier New">Params()</font></li>
            <li><font size="2" face="Courier New">ParsePostfixForParams()</font></li>