treemap.html

来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 852 行 · 第 1/4 页

<B>方法详细信息</B></FONT></TH>
</TR>
</TABLE>

<A NAME="size()"><!-- --></A><H3>
size</H3>
<PRE>
public int <B>size</B>()</PRE>
<DL>
<DD>返回此映射中的键-值映射关系数。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Map.html" title="java.util 中的接口">Map</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="Map.html#size()">size</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractMap.html" title="java.util 中的类">AbstractMap</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractMap.html#size()">size</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>映射中的键-值映射关系数。</DL>
</DD>
</DL>
<HR>

<A NAME="containsKey(java.lang.Object)"><!-- --></A><H3>
containsKey</H3>
<PRE>
public boolean <B>containsKey</B>(<A HREF="../lang/Object.html" title="java.lang 中的类">Object</A>&nbsp;key)</PRE>
<DL>
<DD>如果此映射包含对于指定的键的映射关系，则返回 <tt>true</tt>。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Map.html" title="java.util 中的接口">Map</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="Map.html#containsKey(java.lang.Object)">containsKey</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractMap.html" title="java.util 中的类">AbstractMap</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractMap.html#containsKey(java.lang.Object)">containsKey</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 测试在此映射中存在与否的键。
<DT><B>返回：</B><DD>如果此映射包含指定键的映射关系，则返回 <tt>true</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 如果该键不能与映射中的当前键进行比较。
<DD><CODE><A HREF="../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 键为 <tt>null</tt> 并且此映射使用自然排序，或者它的比较器不允许使用 <tt>null</tt> 键。</DL>
</DD>
</DL>
<HR>

<A NAME="containsValue(java.lang.Object)"><!-- --></A><H3>
containsValue</H3>
<PRE>
public boolean <B>containsValue</B>(<A HREF="../lang/Object.html" title="java.lang 中的类">Object</A>&nbsp;value)</PRE>
<DL>
<DD>如果此映射把一个或多个键映射到指定值，则返回 <tt>true</tt>。更正式地说，当且仅当此映射包含至少一个到值 <tt>v</tt> 的映射关系，并且 <tt>(value==null ? v==null :value.equals(v))</tt>，才返回 <tt>true</tt>。对于大部分 Map 实现而言，此操作需要的时间可能会与 Map 的大小呈线性关系。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Map.html" title="java.util 中的接口">Map</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="Map.html#containsValue(java.lang.Object)">containsValue</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractMap.html" title="java.util 中的类">AbstractMap</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractMap.html#containsValue(java.lang.Object)">containsValue</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>value</CODE> - 要测试其在此 Map 中存在与否的值。
<DT><B>返回：</B><DD>如果到 <tt>value</tt> 的映射关系存在，则返回 <tt>true</tt>；否则，返回 <tt>false</tt>。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="get(java.lang.Object)"><!-- --></A><H3>
get</H3>
<PRE>
public <A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A> <B>get</B>(<A HREF="../lang/Object.html" title="java.lang 中的类">Object</A>&nbsp;key)</PRE>
<DL>
<DD>返回此映射中映射到指定键的值。如果该映射中没有此键的映射关系，则返回 <tt>null</tt>。返回值 <tt>null</tt> 并非<i>一定</i>表明该映射不包含该键的映射关系；也可能此映射将该键显式地映射到 <tt>null</tt>。可使用 <tt>containsKey</tt> 操作区分这两种情况。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Map.html" title="java.util 中的接口">Map</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="Map.html#get(java.lang.Object)">get</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractMap.html" title="java.util 中的类">AbstractMap</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractMap.html#get(java.lang.Object)">get</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 要返回其关联值的键。
<DT><B>返回：</B><DD>此映射将指定键映射到的值，如果映射不包含该键的映射关系，则返回 <tt>null</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 键不能与在映射中的当前键进行比较。
<DD><CODE><A HREF="../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 键为 <tt>null</tt> 并且此映射使用自然排序，或者它的比较器不允许使用 <tt>null</tt> 键。<DT><B>另请参见：</B><DD><A HREF="TreeMap.html#containsKey(java.lang.Object)"><CODE>containsKey(Object)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="comparator()"><!-- --></A><H3>
comparator</H3>
<PRE>
public <A HREF="Comparator.html" title="java.util 中的接口">Comparator</A>&lt;? super <A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>&gt; <B>comparator</B>()</PRE>
<DL>
<DD>返回用于对此映射进行排序的比较器，或者如果此映射使用它的键的自然顺序，则返回 <tt>null</tt>。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="SortedMap.html" title="java.util 中的接口">SortedMap</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="SortedMap.html#comparator()">comparator</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>与此有序映射关联的比较器，如果使用它的键的自然排序方法，则返回 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="firstKey()"><!-- --></A><H3>
firstKey</H3>
<PRE>
public <A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A> <B>firstKey</B>()</PRE>
<DL>
<DD>返回有序映射中当前第一个（最小的）键。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="SortedMap.html" title="java.util 中的接口">SortedMap</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="SortedMap.html#firstKey()">firstKey</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>有序映射中当前第一个（最小的）键。
<DT><B>抛出：</B>
<DD><CODE><A HREF="NoSuchElementException.html" title="java.util 中的类">NoSuchElementException</A></CODE> - 映射为空。</DL>
</DD>
</DL>
<HR>

<A NAME="lastKey()"><!-- --></A><H3>
lastKey</H3>
<PRE>
public <A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A> <B>lastKey</B>()</PRE>
<DL>
<DD>返回有序映射中当前最后一个（最大的）键。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="SortedMap.html" title="java.util 中的接口">SortedMap</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="SortedMap.html#lastKey()">lastKey</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>有序映射中当前最后一个（最大的）键。
<DT><B>抛出：</B>
<DD><CODE><A HREF="NoSuchElementException.html" title="java.util 中的类">NoSuchElementException</A></CODE> - 映射为空。</DL>
</DD>
</DL>
<HR>

<A NAME="putAll(java.util.Map)"><!-- --></A><H3>
putAll</H3>
<PRE>
public void <B>putAll</B>(<A HREF="Map.html" title="java.util 中的接口">Map</A>&lt;? extends <A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,? extends <A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;&nbsp;map)</PRE>
<DL>
<DD>将指定映射中所有映射关系复制到此映射中。针对指定映射中的当前所有键，这些映射关系将替换此映射具有的所有映射关系。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Map.html" title="java.util 中的接口">Map</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="Map.html#putAll(java.util.Map)">putAll</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractMap.html" title="java.util 中的类">AbstractMap</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractMap.html#putAll(java.util.Map)">putAll</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>map</CODE> - 要存储在此映射中的映射关系。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 指定映射中的键或值的类不允许将键或值存储在此映射中。
<DD><CODE><A HREF="../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果给定的映射为 <tt>null</tt> 或者此映射不允许使用 <tt>null</tt> 键，但是指定映射中的键为 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="put(java.lang.Object,java.lang.Object)"><!-- --></A><A NAME="put(K, V)"><!-- --></A><H3>
put</H3>
<PRE>
public <A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A> <B>put</B>(<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>&nbsp;key,
             <A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&nbsp;value)</PRE>
<DL>
<DD>在此映射中关联指定值与指定键。如果映射以前包含一个此键的映射关系，那么将替换原值。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Map.html" title="java.util 中的接口">Map</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="Map.html#put(K, V)">put</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractMap.html" title="java.util 中的类">AbstractMap</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractMap.html#put(K, V)">put</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 指定值将要关联的键。<DD><CODE>value</CODE> - 指定键将要关联的值。
<DT><B>返回：</B><DD>以前与指定键关联的值，或者如果没有该键的映射关系，则返回 <tt>null</tt>。返回 <tt>null</tt> 还可能表示该映射以前关联了 <tt>null</tt> 与指定键。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 键不能与映射中的当前键进行比较。
<DD><CODE><A HREF="../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 键为 <tt>null</tt> 并且此映射使用自然排序，或者它的比较器不允许使用 <tt>null</tt> 键。</DL>
</DD>
</DL>
<HR>

<A NAME="remove(java.lang.Object)"><!-- --></A><H3>
remove</H3>
<PRE>
public <A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A> <B>remove</B>(<A HREF="../lang/Object.html" title="java.lang 中的类">Object</A>&nbsp;key)</PRE>
<DL>
<DD>如果此 TreeMap 中存在该键的映射关系，则将其移除。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Map.html" title="java.util 中的接口">Map</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="Map.html#remove(java.lang.Object)">remove</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractMap.html" title="java.util 中的类">AbstractMap</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractMap.html#remove(java.lang.Object)">remove</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>key</CODE> - 应该删除映射关系的键
<DT><B>返回：</B><DD>以前与指定的键关联的值，如果没有该键的映射关系，则返回 <tt>null</tt>。返回 <tt>null</tt> 还可能表示该映射以前关联了 <tt>null</tt> 与指定键。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 键不能和映射中的当前键进行比较。
<DD><CODE><A HREF="../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 键为 <tt>null</tt> 并且此映射使用自然排序，或者它的比较器不允许使用 <tt>null</tt> 键。</DL>
</DD>
</DL>
<HR>

<A NAME="clear()"><!-- --></A><H3>
clear</H3>
<PRE>
public void <B>clear</B>()</PRE>
<DL>
<DD>从此 TreeMap 中删除所有映射关系。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Map.html" title="java.util 中的接口">Map</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="Map.html#clear()">clear</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="AbstractMap.html" title="java.util 中的类">AbstractMap</A>&lt;<A HREF="TreeMap.html" title="TreeMap 中的类型参数">K</A>,<A HREF="TreeMap.html" title="TreeMap 中的类型参数">V</A>&gt;</CODE> 中的 <CODE><A HREF="AbstractMap.html#clear()">clear</A></CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="clone()"><!-- --></A><H3>
clone</H3>