<!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.4.2) on Sun Oct 19 20:56:56 NOVST 2003 --> <TITLE> DbStringSet </TITLE> <META NAME="keywords" CONTENT="net.sourceforge.pain.db.DbStringSet class"> <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style"> <SCRIPT type="text/javascript"> function windowTitle() { parent.document.title="DbStringSet"; } </SCRIPT> </HEAD> <BODY BGCOLOR="white" onload="windowTitle();"> <!-- ========= 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=3 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="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="../../../../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="../../../../net/sourceforge/pain/db/DbStringMap.html" title="class in net.sourceforge.pain.db"><B>PREV CLASS</B></A> <A HREF="../../../../net/sourceforge/pain/db/DbType.html" title="class in net.sourceforge.pain.db"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../../index.html" target="_top"><B>FRAMES</B></A> <A HREF="DbStringSet.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 | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <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"> net.sourceforge.pain.db</FONT> <BR> Class DbStringSet</H2> <PRE> java.lang.Object <IMG SRC="../../../../resources/inherit.gif" ALT="extended by">net.sourceforge.pain.db.DbCollection <IMG SRC="../../../../resources/inherit.gif" ALT="extended by">net.sourceforge.pain.db.DbAbstractStringMap <IMG SRC="../../../../resources/inherit.gif" ALT="extended by"><B>net.sourceforge.pain.db.DbStringSet</B> </PRE> <DL> <DT><B>All Implemented Interfaces:</B> <DD>java.util.Collection, java.util.Set</DD> </DL> <HR> <DL> <DT>public final class <B>DbStringSet</B><DT>extends net.sourceforge.pain.db.DbAbstractStringMap<DT>implements java.util.Set</DL> <P> This class implements the <tt>Set</tt> interface. Only not null String values supported.<br> PAiN Db will not support more general serializable objects Set as it brokes database design<br> but Strings(Immutable) Sets are too convinient to be missed. This class is still experimental and could be removed with next release. (possible usage alternative: Cookie class and StingKeyMap) <P> <P> <HR> <P> <!-- ======== NESTED CLASS SUMMARY ======== --> <!-- =========== FIELD SUMMARY =========== --> <!-- ======== CONSTRUCTOR SUMMARY ======== --> <A NAME="constructor_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TD COLSPAN=2><FONT SIZE="+2"> <B>Constructor Summary</B></FONT></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#DbStringSet(net.sourceforge.pain.db.DbObject, int)">DbStringSet</A></B>(<A HREF="../../../../net/sourceforge/pain/db/DbObject.html" title="class in net.sourceforge.pain.db">DbObject</A> owner, int fid)</CODE> <BR> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#DbStringSet(net.sourceforge.pain.db.DbObject, java.lang.String[], int)">DbStringSet</A></B>(<A HREF="../../../../net/sourceforge/pain/db/DbObject.html" title="class in net.sourceforge.pain.db">DbObject</A> owner, java.lang.String[] image, int fid)</CODE> <BR> </TD> </TR> </TABLE> <!-- ========== METHOD SUMMARY =========== --> <A NAME="method_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TD COLSPAN=2><FONT SIZE="+2"> <B>Method Summary</B></FONT></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#add(java.lang.Object)">add</A></B>(java.lang.Object o)</CODE> <BR> Adds the specified element to this set if it is not already present (optional operation).</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#addAll(java.util.Collection)">addAll</A></B>(java.util.Collection c)</CODE> <BR> Adds all of the elements in the specified collection to this set if they're not already present (optional operation).</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#clear()">clear</A></B>()</CODE> <BR> Removes all of the elements from this set (optional operation).</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#contains(java.lang.Object)">contains</A></B>(java.lang.Object o)</CODE> <BR> Returns <tt>true</tt> if this set contains the specified element.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#containsAll(java.util.Collection)">containsAll</A></B>(java.util.Collection c)</CODE> <BR> Returns <tt>true</tt> if this set contains all of the elements of the specified collection.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#isEmpty()">isEmpty</A></B>()</CODE> <BR> Returns <tt>true</tt> if this set contains no elements.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.util.Iterator</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#iterator()">iterator</A></B>()</CODE> <BR> Returns an iterator over the elements in this set.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#remove(java.lang.Object)">remove</A></B>(java.lang.Object o)</CODE> <BR> Removes the specified element from this set if it is present (optional operation).</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#removeAll(java.util.Collection)">removeAll</A></B>(java.util.Collection c)</CODE> <BR> Removes from this set all of its elements that are contained in the specified collection (optional operation).</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#retainAll(java.util.Collection)">retainAll</A></B>(java.util.Collection c)</CODE> <BR> Retains only the elements in this set that are contained in the specified collection (optional operation).</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#size()">size</A></B>()</CODE> <BR> Returns the number of elements in this set (its cardinality).</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.Object[]</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#toArray()">toArray</A></B>()</CODE> <BR> Returns an array containing all of the elements in this set.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.Object[]</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../net/sourceforge/pain/db/DbStringSet.html#toArray(java.lang.Object[])">toArray</A></B>(java.lang.Object[] a)</CODE> <BR> Returns an array containing all of the elements in this set; the runtime type of the returned array is that of the specified array.</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"> <TD><B>Methods inherited from class java.lang.Object</B></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_java.util.Set"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TD><B>Methods inherited from interface java.util.Set</B></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE>equals, hashCode</CODE></TD> </TR> </TABLE> <P> <!-- ============ FIELD DETAIL =========== --> <!-- ========= CONSTRUCTOR DETAIL ======== --> <A NAME="constructor_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TD COLSPAN=1><FONT SIZE="+2"> <B>Constructor Detail</B></FONT></TD> </TR> </TABLE> <A NAME="DbStringSet(net.sourceforge.pain.db.DbObject, java.lang.String[], int)"><!-- --></A><H3> DbStringSet</H3> <PRE> public <B>DbStringSet</B>(<A HREF="../../../../net/sourceforge/pain/db/DbObject.html" title="class in net.sourceforge.pain.db">DbObject</A> owner, java.lang.String[] image, int fid)</PRE> <DL> </DL> <HR> <A NAME="DbStringSet(net.sourceforge.pain.db.DbObject, int)"><!-- --></A><H3> DbStringSet</H3> <PRE> public <B>DbStringSet</B>(<A HREF="../../../../net/sourceforge/pain/db/DbObject.html" title="class in net.sourceforge.pain.db">DbObject</A> owner, int fid)</PRE> <DL> </DL> <!-- ============ METHOD DETAIL ========== --> <A NAME="method_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TD COLSPAN=1><FONT SIZE="+2"> <B>Method Detail</B></FONT></TD> </TR> </TABLE> <A NAME="size()"><!-- --></A><H3> size</H3> <PRE> public int <B>size</B>()</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Returns the number of elements in this set (its cardinality). If this set contains more than <tt>Integer.MAX_VALUE</tt> elements, returns <tt>Integer.MAX_VALUE</tt>. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>size</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>the number of elements in this set (its cardinality).</DL> </DD> </DL> <HR> <A NAME="clear()"><!-- --></A><H3> clear</H3> <PRE> public void <B>clear</B>()</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Removes all of the elements from this set (optional operation). This set will be empty after this call returns (unless it throws an exception). <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>clear</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="isEmpty()"><!-- --></A><H3> isEmpty</H3> <PRE> public boolean <B>isEmpty</B>()</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Returns <tt>true</tt> if this set contains no elements. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>isEmpty</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> <DT><B>Returns:</B><DD><tt>true</tt> if this set contains no elements.</DL> </DD> </DL> <HR> <A NAME="toArray()"><!-- --></A><H3> toArray</H3> <PRE> public java.lang.Object[] <B>toArray</B>()</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Returns an array containing all of the elements in this set. Obeys the general contract of the <tt>Collection.toArray</tt> method. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>toArray</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>an array containing all of the elements in this set.</DL> </DD> </DL> <HR> <A NAME="add(java.lang.Object)"><!-- --></A><H3> add</H3> <PRE> public boolean <B>add</B>(java.lang.Object o)</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Adds the specified element to this set if it is not already present (optional operation). More formally, adds the specified element, <code>o</code>, to this set if this set contains no element <code>e</code> such that <code>(o==null ? e==null : o.equals(e))</code>. If this set already contains the specified element, the call leaves this set unchanged and returns <tt>false</tt>. In combination with the restriction on constructors, this ensures that sets never contain duplicate elements.<p> The stipulation above does not imply that sets must accept all elements; sets may refuse to add any particular element, including <tt>null</tt>, and throwing an exception, as described in the specification for <tt>Collection.add</tt>. Individual set implementations should clearly document any restrictions on the the elements that they may contain. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>add</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>o</CODE> - element to be added to this set. <DT><B>Returns:</B><DD><tt>true</tt> if this set did not already contain the specified element.</DL> </DD> </DL> <HR> <A NAME="contains(java.lang.Object)"><!-- --></A><H3> contains</H3> <PRE> public boolean <B>contains</B>(java.lang.Object o)</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Returns <tt>true</tt> if this set contains the specified element. More formally, returns <tt>true</tt> if and only if this set contains an element <code>e</code> such that <code>(o==null ? e==null : o.equals(e))</code>. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>contains</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>o</CODE> - element whose presence in this set is to be tested. <DT><B>Returns:</B><DD><tt>true</tt> if this set contains the specified element.</DL> </DD> </DL> <HR> <A NAME="remove(java.lang.Object)"><!-- --></A><H3> remove</H3> <PRE> public boolean <B>remove</B>(java.lang.Object o)</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Removes the specified element from this set if it is present (optional operation). More formally, removes an element <code>e</code> such that <code>(o==null ? e==null : o.equals(e))</code>, if the set contains such an element. Returns <tt>true</tt> if the set contained the specified element (or equivalently, if the set changed as a result of the call). (The set will not contain the specified element once the call returns.) <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>remove</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>o</CODE> - object to be removed from this set, if present. <DT><B>Returns:</B><DD>true if the set contained the specified element.</DL> </DD> </DL> <HR> <A NAME="addAll(java.util.Collection)"><!-- --></A><H3> addAll</H3> <PRE> public boolean <B>addAll</B>(java.util.Collection c)</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Adds all of the elements in the specified collection to this set if they're not already present (optional operation). If the specified collection is also a set, the <tt>addAll</tt> operation effectively modifies this set so that its value is the <i>union</i> of the two sets. The behavior of this operation is unspecified if the specified collection is modified while the operation is in progress. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>addAll</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>c</CODE> - collection whose elements are to be added to this set. <DT><B>Returns:</B><DD><tt>true</tt> if this set changed as a result of the call.<DT><B>See Also:</B><DD><CODE>Set.add(Object)</CODE></DL> </DD> </DL> <HR> <A NAME="containsAll(java.util.Collection)"><!-- --></A><H3> containsAll</H3> <PRE> public boolean <B>containsAll</B>(java.util.Collection c)</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Returns <tt>true</tt> if this set contains all of the elements of the specified collection. If the specified collection is also a set, this method returns <tt>true</tt> if it is a <i>subset</i> of this set. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>containsAll</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>c</CODE> - collection to be checked for containment in this set. <DT><B>Returns:</B><DD><tt>true</tt> if this set contains all of the elements of the specified collection.<DT><B>See Also:</B><DD><CODE>Set.contains(Object)</CODE></DL> </DD> </DL> <HR> <A NAME="removeAll(java.util.Collection)"><!-- --></A><H3> removeAll</H3> <PRE> public boolean <B>removeAll</B>(java.util.Collection c)</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Removes from this set all of its elements that are contained in the specified collection (optional operation). If the specified collection is also a set, this operation effectively modifies this set so that its value is the <i>asymmetric set difference</i> of the two sets. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>removeAll</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>c</CODE> - collection that defines which elements will be removed from this set. <DT><B>Returns:</B><DD><tt>true</tt> if this set changed as a result of the call.<DT><B>See Also:</B><DD><CODE>Set.remove(Object)</CODE></DL> </DD> </DL> <HR> <A NAME="retainAll(java.util.Collection)"><!-- --></A><H3> retainAll</H3> <PRE> public boolean <B>retainAll</B>(java.util.Collection c)</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Retains only the elements in this set that are contained in the specified collection (optional operation). In other words, removes from this set all of its elements that are not contained in the specified collection. If the specified collection is also a set, this operation effectively modifies this set so that its value is the <i>intersection</i> of the two sets. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>retainAll</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>c</CODE> - collection that defines which elements this set will retain. <DT><B>Returns:</B><DD><tt>true</tt> if this collection changed as a result of the call.<DT><B>See Also:</B><DD><CODE>Set.remove(Object)</CODE></DL> </DD> </DL> <HR> <A NAME="iterator()"><!-- --></A><H3> iterator</H3> <PRE> public java.util.Iterator <B>iterator</B>()</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Returns an iterator over the elements in this set. The elements are returned in no particular order (unless this set is an instance of some class that provides a guarantee). <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>iterator</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>an iterator over the elements in this set.</DL> </DD> </DL> <HR> <A NAME="toArray(java.lang.Object[])"><!-- --></A><H3> toArray</H3> <PRE> public java.lang.Object[] <B>toArray</B>(java.lang.Object[] a)</PRE> <DL> <DD><B>Description copied from interface: <CODE>java.util.Set</CODE></B></DD> <DD>Returns an array containing all of the elements in this set; the runtime type of the returned array is that of the specified array. Obeys the general contract of the <tt>Collection.toArray(Object[])</tt> method. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE>toArray</CODE> in interface <CODE>java.util.Set</CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>a</CODE> - the array into which the elements of this set are to be stored, if it is big enough; otherwise, a new array of the same runtime type is allocated for this purpose. <DT><B>Returns:</B><DD>an array containing the elements of this set.</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=3 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="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="../../../../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="../../../../net/sourceforge/pain/db/DbStringMap.html" title="class in net.sourceforge.pain.db"><B>PREV CLASS</B></A> <A HREF="../../../../net/sourceforge/pain/db/DbType.html" title="class in net.sourceforge.pain.db"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../../index.html" target="_top"><B>FRAMES</B></A> <A HREF="DbStringSet.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 | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> </TR> </TABLE> <A NAME="skip-navbar_bottom"></A> <!-- ======== END OF BOTTOM NAVBAR ======= --> <HR> </BODY> </HTML>