<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.6.0_18) on Thu Dec 02 16:59:42 UTC 2010 -->
<TITLE>
StoredCollections
</TITLE>
<META NAME="date" CONTENT="2010-12-02">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="StoredCollections";
}
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../com/sleepycat/bdb/collection/StoredCollection.html" title="class in com.sleepycat.bdb.collection"><B>PREV CLASS</B></A>
<A HREF="../../../../com/sleepycat/bdb/collection/StoredContainer.html" title="class in com.sleepycat.bdb.collection"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../index.html?com/sleepycat/bdb/collection/StoredCollections.html" target="_top"><B>FRAMES</B></A>
<A HREF="StoredCollections.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
com.sleepycat.bdb.collection</FONT>
<BR>
Class StoredCollections</H2>
<PRE>
java.lang.Object
<IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>com.sleepycat.bdb.collection.StoredCollections</B>
</PRE>
<HR>
<DL>
<DT><PRE>public class <B>StoredCollections</B><DT>extends java.lang.Object</DL>
</PRE>
<P>
This class consists exclusively of static methods that operate on or return
stored collections. It contains methods for changing certain properties of a
collection. Because collection properties are immutable, these methods
always return a new collection reference. This allows stored collections to
be used safely by multiple threads. Note that creating the new collection
reference is not expensive and creates only two new objects.
<p>When a collection is created with a particular property, all collections
and iterators derieved from that collection will inherit the property. For
example, if a dirty-read Map is created then calls to subMap(), values(),
entrySet(), and keySet() will create dirty-read collections also.</p>
<p><b>Dirty-Read</b> Methods names beginning with dirtyRead create a new
dirty-read container from a given stored container. When dirty-read is
enabled, data will be read that has been modified by another transaction but
not committed. Using dirty-read can improve concurrency since reading will
not wait for other transactions to complete. For a non-transactional
container (when <A HREF="../../../../com/sleepycat/bdb/collection/StoredContainer.html#isTransactional()"><CODE>StoredContainer.isTransactional()</CODE></A> returns false),
dirty-read has no effect. If <A HREF="../../../../com/sleepycat/bdb/collection/StoredContainer.html#isDirtyReadAllowed()"><CODE>StoredContainer.isDirtyReadAllowed()</CODE></A>
returns false, dirty-read also has no effect. If dirty-ready is enabled
(and allowed) for a container, <A HREF="../../../../com/sleepycat/bdb/collection/StoredContainer.html#isDirtyReadEnabled()"><CODE>StoredContainer.isDirtyReadEnabled()</CODE></A>
will return true. Dirty-read is disabled by default for a container.</p>
<p><b>Auto-Commit</b> Methods names beginning with autoCommit create a new
auto-commit container from a given stored container. If auto-commit is
enabled for a container (or for its <A HREF="../../../../com/sleepycat/db/DbEnv.html" title="class in com.sleepycat.db"><CODE>DbEnv</CODE></A>), a transaction will be
started and committed automatically for each write operation when no
transaction is already active. Auto-commit only applies to container
methods. It does not apply to iterator methods and these always require an
active transaction. For a non-transactional container (where <A HREF="../../../../com/sleepycat/bdb/collection/StoredContainer.html#isTransactional()"><CODE>StoredContainer.isTransactional()</CODE></A> returns false) auto-commit has no effect.
If auto-commit is enabled for a transactional container or its environment,
<A HREF="../../../../com/sleepycat/bdb/collection/StoredContainer.html#isAutoCommit()"><CODE>StoredContainer.isAutoCommit()</CODE></A> will return true. Auto-commit is
disabled by default for a container but may be enabled for an entire
environment using <A HREF="../../../../com/sleepycat/db/DbEnv.html#setFlags(int, boolean)"><CODE>DbEnv.setFlags(int, boolean)</CODE></A>.</p>
<P>
<P>
<HR>
<P>
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Method Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.Collection</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#autoCommitCollection(java.util.Collection)">autoCommitCollection</A></B>(java.util.Collection storedCollection)</CODE>
<BR>
Creates a auto-commit collection from a given stored collection.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.List</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#autoCommitList(java.util.List)">autoCommitList</A></B>(java.util.List storedList)</CODE>
<BR>
Creates a auto-commit list from a given stored list.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.Map</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#autoCommitMap(java.util.Map)">autoCommitMap</A></B>(java.util.Map storedMap)</CODE>
<BR>
Creates a auto-commit map from a given stored map.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.Set</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#autoCommitSet(java.util.Set)">autoCommitSet</A></B>(java.util.Set storedSet)</CODE>
<BR>
Creates a auto-commit set from a given stored set.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.SortedMap</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#autoCommitSortedMap(java.util.SortedMap)">autoCommitSortedMap</A></B>(java.util.SortedMap storedSortedMap)</CODE>
<BR>
Creates a auto-commit sorted map from a given stored sorted map.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.SortedSet</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#autoCommitSortedSet(java.util.SortedSet)">autoCommitSortedSet</A></B>(java.util.SortedSet storedSortedSet)</CODE>
<BR>
Creates a auto-commit sorted set from a given stored sorted set.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.Collection</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#dirtyReadCollection(java.util.Collection)">dirtyReadCollection</A></B>(java.util.Collection storedCollection)</CODE>
<BR>
Creates a dirty-read collection from a given stored collection.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.List</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#dirtyReadList(java.util.List)">dirtyReadList</A></B>(java.util.List storedList)</CODE>
<BR>
Creates a dirty-read list from a given stored list.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.Map</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#dirtyReadMap(java.util.Map)">dirtyReadMap</A></B>(java.util.Map storedMap)</CODE>
<BR>
Creates a dirty-read map from a given stored map.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.Set</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#dirtyReadSet(java.util.Set)">dirtyReadSet</A></B>(java.util.Set storedSet)</CODE>
<BR>
Creates a dirty-read set from a given stored set.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.SortedMap</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#dirtyReadSortedMap(java.util.SortedMap)">dirtyReadSortedMap</A></B>(java.util.SortedMap storedSortedMap)</CODE>
<BR>
Creates a dirty-read sorted map from a given stored sorted map.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.SortedSet</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#dirtyReadSortedSet(java.util.SortedSet)">dirtyReadSortedSet</A></B>(java.util.SortedSet storedSortedSet)</CODE>
<BR>
Creates a dirty-read sorted set from a given stored sorted set.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.util.Iterator</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/sleepycat/bdb/collection/StoredCollections.html#iterator(java.util.Iterator)">iterator</A></B>(java.util.Iterator storedIterator)</CODE>
<BR>
Clones a stored iterator preserving its current position.</TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
<P>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="dirtyReadCollection(java.util.Collection)"><!-- --></A><H3>
dirtyReadCollection</H3>
<PRE>
public static java.util.Collection <B>dirtyReadCollection</B>(java.util.Collection storedCollection)</PRE>
<DL>
<DD>Creates a dirty-read collection from a given stored collection.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedCollection</CODE> - the base collection.
<DT><B>Returns:</B><DD>the dirty-read collection.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given container is not a
StoredContainer.</DL>
</DD>
</DL>
<HR>
<A NAME="dirtyReadList(java.util.List)"><!-- --></A><H3>
dirtyReadList</H3>
<PRE>
public static java.util.List <B>dirtyReadList</B>(java.util.List storedList)</PRE>
<DL>
<DD>Creates a dirty-read list from a given stored list.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedList</CODE> - the base list.
<DT><B>Returns:</B><DD>the dirty-read list.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given container is not a
StoredContainer.</DL>
</DD>
</DL>
<HR>
<A NAME="dirtyReadMap(java.util.Map)"><!-- --></A><H3>
dirtyReadMap</H3>
<PRE>
public static java.util.Map <B>dirtyReadMap</B>(java.util.Map storedMap)</PRE>
<DL>
<DD>Creates a dirty-read map from a given stored map.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedMap</CODE> - the base map.
<DT><B>Returns:</B><DD>the dirty-read map.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given container is not a
StoredContainer.</DL>
</DD>
</DL>
<HR>
<A NAME="dirtyReadSet(java.util.Set)"><!-- --></A><H3>
dirtyReadSet</H3>
<PRE>
public static java.util.Set <B>dirtyReadSet</B>(java.util.Set storedSet)</PRE>
<DL>
<DD>Creates a dirty-read set from a given stored set.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedSet</CODE> - the base set.
<DT><B>Returns:</B><DD>the dirty-read set.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given container is not a
StoredContainer.</DL>
</DD>
</DL>
<HR>
<A NAME="dirtyReadSortedMap(java.util.SortedMap)"><!-- --></A><H3>
dirtyReadSortedMap</H3>
<PRE>
public static java.util.SortedMap <B>dirtyReadSortedMap</B>(java.util.SortedMap storedSortedMap)</PRE>
<DL>
<DD>Creates a dirty-read sorted map from a given stored sorted map.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedSortedMap</CODE> - the base map.
<DT><B>Returns:</B><DD>the dirty-read map.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given container is not a
StoredContainer.</DL>
</DD>
</DL>
<HR>
<A NAME="dirtyReadSortedSet(java.util.SortedSet)"><!-- --></A><H3>
dirtyReadSortedSet</H3>
<PRE>
public static java.util.SortedSet <B>dirtyReadSortedSet</B>(java.util.SortedSet storedSortedSet)</PRE>
<DL>
<DD>Creates a dirty-read sorted set from a given stored sorted set.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedSortedSet</CODE> - the base set.
<DT><B>Returns:</B><DD>the dirty-read set.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given container is not a
StoredContainer.</DL>
</DD>
</DL>
<HR>
<A NAME="autoCommitCollection(java.util.Collection)"><!-- --></A><H3>
autoCommitCollection</H3>
<PRE>
public static java.util.Collection <B>autoCommitCollection</B>(java.util.Collection storedCollection)</PRE>
<DL>
<DD>Creates a auto-commit collection from a given stored collection.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedCollection</CODE> - the base collection.
<DT><B>Returns:</B><DD>the auto-commit collection.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given container is not a
StoredContainer.</DL>
</DD>
</DL>
<HR>
<A NAME="autoCommitList(java.util.List)"><!-- --></A><H3>
autoCommitList</H3>
<PRE>
public static java.util.List <B>autoCommitList</B>(java.util.List storedList)</PRE>
<DL>
<DD>Creates a auto-commit list from a given stored list.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedList</CODE> - the base list.
<DT><B>Returns:</B><DD>the auto-commit list.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given container is not a
StoredContainer.</DL>
</DD>
</DL>
<HR>
<A NAME="autoCommitMap(java.util.Map)"><!-- --></A><H3>
autoCommitMap</H3>
<PRE>
public static java.util.Map <B>autoCommitMap</B>(java.util.Map storedMap)</PRE>
<DL>
<DD>Creates a auto-commit map from a given stored map.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedMap</CODE> - the base map.
<DT><B>Returns:</B><DD>the auto-commit map.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given container is not a
StoredContainer.</DL>
</DD>
</DL>
<HR>
<A NAME="autoCommitSet(java.util.Set)"><!-- --></A><H3>
autoCommitSet</H3>
<PRE>
public static java.util.Set <B>autoCommitSet</B>(java.util.Set storedSet)</PRE>
<DL>
<DD>Creates a auto-commit set from a given stored set.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedSet</CODE> - the base set.
<DT><B>Returns:</B><DD>the auto-commit set.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given container is not a
StoredContainer.</DL>
</DD>
</DL>
<HR>
<A NAME="autoCommitSortedMap(java.util.SortedMap)"><!-- --></A><H3>
autoCommitSortedMap</H3>
<PRE>
public static java.util.SortedMap <B>autoCommitSortedMap</B>(java.util.SortedMap storedSortedMap)</PRE>
<DL>
<DD>Creates a auto-commit sorted map from a given stored sorted map.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedSortedMap</CODE> - the base map.
<DT><B>Returns:</B><DD>the auto-commit map.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given container is not a
StoredContainer.</DL>
</DD>
</DL>
<HR>
<A NAME="autoCommitSortedSet(java.util.SortedSet)"><!-- --></A><H3>
autoCommitSortedSet</H3>
<PRE>
public static java.util.SortedSet <B>autoCommitSortedSet</B>(java.util.SortedSet storedSortedSet)</PRE>
<DL>
<DD>Creates a auto-commit sorted set from a given stored sorted set.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedSortedSet</CODE> - the base set.
<DT><B>Returns:</B><DD>the auto-commit set.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given container is not a
StoredContainer.</DL>
</DD>
</DL>
<HR>
<A NAME="iterator(java.util.Iterator)"><!-- --></A><H3>
iterator</H3>
<PRE>
public static java.util.Iterator <B>iterator</B>(java.util.Iterator storedIterator)</PRE>
<DL>
<DD>Clones a stored iterator preserving its current position.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>storedIterator</CODE> - an iterator to clone.
<DT><B>Returns:</B><DD>a new <A HREF="../../../../com/sleepycat/bdb/collection/StoredIterator.html" title="class in com.sleepycat.bdb.collection"><CODE>StoredIterator</CODE></A> having the same position as the
given iterator.
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the given iterator is not a
StoredIterator.</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../com/sleepycat/bdb/collection/StoredCollection.html" title="class in com.sleepycat.bdb.collection"><B>PREV CLASS</B></A>
<A HREF="../../../../com/sleepycat/bdb/collection/StoredContainer.html" title="class in com.sleepycat.bdb.collection"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../index.html?com/sleepycat/bdb/collection/StoredCollections.html" target="_top"><B>FRAMES</B></A>
<A HREF="StoredCollections.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<HR>
</BODY>
</HTML>
