comparable.html
来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 262 行 · 第 1/2 页
HTML
262 行
<!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.5.0_03) on Wed Nov 02 09:48:21 CST 2005 --><META http-equiv="Content-Type" content="text/html; charset=gb2312"><TITLE>Comparable (Java 2 Platform SE 5.0)</TITLE><META NAME="keywords" CONTENT="java.lang.Comparable interface"><LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style"><SCRIPT type="text/javascript">function windowTitle(){ parent.document.title="Comparable (Java 2 Platform SE 5.0)";}</SCRIPT><NOSCRIPT></NOSCRIPT></HEAD><BODY BGCOLOR="white" onload="windowTitle();"><!-- ========= START OF TOP NAVBAR ======= --><A NAME="navbar_top"><!-- --></A><A HREF="#skip-navbar_top" title="跳过导航链接"></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>概述</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>类</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/Comparable.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM><b>Java<sup><font size=-2>TM</font></sup> 2 Platform<br>Standard Ed. 5.0</b></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="CloneNotSupportedException.html" title="java.lang 中的类"><B>上一个类</B></A> <A HREF="Compiler.html" title="java.lang 中的类"><B>下一个类</B></A></FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../index.html@java_2Flang_2FComparable.html" target="_top"><B>框架</B></A> <A HREF="Comparable.html" target="_top"><B>无框架</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../allclasses-noframe.html"><B>所有类</B></A>'); } //--></SCRIPT><NOSCRIPT> <A HREF="../../allclasses-noframe.html"><B>所有类</B></A></NOSCRIPT></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 摘要： 嵌套 | 字段 | 构造方法 | <A HREF="#method_summary">方法</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">详细信息： 字段 | 构造方法 | <A HREF="#method_detail">方法</A></FONT></TD></TR></TABLE><A NAME="skip-navbar_top"></A><!-- ========= END OF TOP NAVBAR ========= --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">java.lang</FONT><BR>接口 Comparable<T></H2><DL><DT><B>所有已知子接口：</B> <DD><A HREF="../util/concurrent/Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>, <A HREF="../util/concurrent/ScheduledFuture.html" title="java.util.concurrent 中的接口">ScheduledFuture</A><V></DD></DL><DL><DT><B>所有已知实现类：</B> <DD><A HREF="Boolean.html" title="java.lang 中的类">Boolean</A>, <A HREF="Byte.html" title="java.lang 中的类">Byte</A>, <A HREF="../util/Calendar.html" title="java.util 中的类">Calendar</A>, <A HREF="Character.html" title="java.lang 中的类">Character</A>, <A HREF="../util/Date.html" title="java.util 中的类">Date</A>, <A HREF="Double.html" title="java.lang 中的类">Double</A>, <A HREF="annotation/ElementType.html" title="java.lang.annotation 中的枚举">ElementType</A>, <A HREF="Enum.html" title="java.lang 中的类">Enum</A>, <A HREF="Float.html" title="java.lang 中的类">Float</A>, <A HREF="../util/Formatter.BigDecimalLayoutForm.html" title="java.util 中的枚举">Formatter.BigDecimalLayoutForm</A>, <A HREF="../util/GregorianCalendar.html" title="java.util 中的类">GregorianCalendar</A>, <A HREF="Integer.html" title="java.lang 中的类">Integer</A>, <A HREF="Long.html" title="java.lang 中的类">Long</A>, <A HREF="management/MemoryType.html" title="java.lang.management 中的枚举">MemoryType</A>, <A HREF="annotation/RetentionPolicy.html" title="java.lang.annotation 中的枚举">RetentionPolicy</A>, <A HREF="Short.html" title="java.lang 中的类">Short</A>, <A HREF="String.html" title="java.lang 中的类">String</A>, <A HREF="Thread.State.html" title="java.lang 中的枚举">Thread.State</A>, <A HREF="../util/concurrent/TimeUnit.html" title="java.util.concurrent 中的枚举">TimeUnit</A>, <A HREF="../util/UUID.html" title="java.util 中的类">UUID</A></DD></DL><HR><DL><DT><PRE>public interface <B>Comparable<T></B></DL></PRE><P>此接口强行对实现它的每个类的对象进行整体排序。此排序被称为该类的<i>自然排序</i>，类的 <tt>compareTo</tt> 方法被称为它的<i>自然比较方法</i>。<p>实现此接口的对象列表（和数组）可以通过 <tt>Collections.sort</tt>（和 <tt>Arrays.sort</tt>）进行自动排序。实现此接口的对象可以用作有序映射表中的键或有序集合中的元素，无需指定比较器。<p>对于类 <tt>C</tt> 的每一个 <tt>e1</tt> 和 <tt>e2</tt> 来说，当且仅当 <tt>(e1.compareTo((Object)e2) == 0)</tt> 与 <tt>e1.equals((Object)e2)</tt> 具有相同的布尔值时，类 <tt>C</tt> 的自然排序才叫做<i>与 equals 方法一致</i>。注意，<tt>null</tt> 不是任何类的实例，即使 <tt>e.equals(null)</tt> 返回 <tt>false</tt>，<tt>e.compareTo(null)</tt> 也会抛出 <tt>NullPointerException</tt>。<p>强烈推荐（虽然不是必需的）使自然排序与 equals 方法一致。这是因为在使用其自然排序与 equals 方法不一致的元素（或键）时，没有显式比较器的有序集合（和有序映射表）行为表现“怪异”。尤其是，这样的有序集合（或有序映射表）违背了根据 <tt>equals</tt> 方法定义的集合（或映射表）的常规协定。<p>例如，如果将两个键 <tt>a</tt> 和 <tt>b</tt> 添加到一个没有使用显式比较器的有序集合中，使得 <tt>(!a.equals((Object)b) && a.compareTo((Object)b) == 0)</tt>，则第二个 <tt>add</tt> 操作返回 false（有序集合的大小没有增加），因为从有序集合的角度来看，<tt>a</tt> 和 <tt>b</tt> 是等效的。<p>实际上，所有执行比较的 Java 核心类都具有与 equals 方法一致的自然排序。<tt>java.math.BigDecimal</tt> 是个例外，它的自然排序把值相等但精确度不同的 <tt>BigDecimal</tt> 对象（比如 4.0 和 4.00）等同起来。<p>为了向数学上倾斜，在给定 C 类的基础上定义自然排序的<i>关系</i> 如下：<pre> {(x, y) such that x.compareTo((Object)y) <= 0}。</pre> 整体排序的 <i>quotient</i> 是：<pre> {(x, y) such that x.compareTo((Object)y) == 0}。</pre>它直接遵循 <tt>compareTo</tt> 的协定，商是 <tt>C</tt> 的<i>等价关系</i>，自然排序是 <tt>C</tt> 的<i>整体排序</i>。当我们说类的自然排序<i>与 equals 方法一致</i> 时，是指自然排序的商是由类的 <tt>equals(Object)</tt> 方法定义的等价关系。<pre> {(x, y) such that x.equals((Object)y)}。 </pre><p>此接口是 <a href="../../../guide/collections/index.html">Java Collections Framework</a> 的成员。<P><P><DL><DT><B>从以下版本开始：</B></DT>⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?