Comparable

public interface Comparable

Known Indirect Subclasses Allocation.MipmapControl, AlphabeticIndex.Bucket.LabelType, AsyncTask.Status, Authenticator.RequestorType, BigDecimal, BigInteger, Bitmap.CompressFormat, Bitmap.Config, BlurMaskFilter.Blur, Boolean, BuddhistCalendar, Byte, and 152 others. Allocation.MipmapControl 控制使用位图创建和更新功能时的mipmap行为。 AlphabeticIndex.Bucket.LabelType 标签的类型 AsyncTask.Status 指示任务的当前状态。 Authenticator.RequestorType 请求认证的实体的类型。 BigDecimal BigDecimal类实现不可变的任意精度十进制数。 BigInteger 一个不可变的任意精度有符号整数。 Bitmap.CompressFormat 指定位图可以压缩到的已知格式 Bitmap.Config 可能的位图配置。 BlurMaskFilter.Blur   Boolean 布尔类将原始类型 boolean的值包装在对象中。 BuddhistCalendar BuddhistCalendar是的子类 GregorianCalendar ，因为佛的诞生是数年。 Byte 所述 Byte类包装一个基本类型的值 byte中的对象。 ByteBuffer 一个字节缓冲区。 CRLReason CRLReason枚举指定证书被吊销的原因，如 RFC 3280: Internet X.509 Public Key Infrastructure Certificate and CRL Profile中所定义。 Calendar [icu增强] ICU的替代Calendar 。 ICU特有的方法，字段和其他功能标记为“ [icu] ”。 Canvas.EdgeType   Canvas.VertexMode   CertPathValidatorException.BasicReason BasicReason列举了任何类型的认证路径可能无效的潜在原因。 CharBuffer 一个字符缓冲区。 Character Character类将原始类型 char的值包装在对象中。 Character.UnicodeScript 表示在 Unicode Standard Annex #24: Script Names中定义的字符脚本的一系列字符子集。 Charset 16位Unicode code units序列与字节序列之间的命名映射。 CheckBoxPreference 提供复选框小部件功能的 Preference 。 ChineseCalendar ChineseCalendar是实现中国传统日历的 Calendar的具体子类。 ClientInfoStatus 列举了无法通过调用 Connection.setClientInfo来设置属性的原因的状态 CollationKey 甲 CollationKey表示 String下一个特定的规则 Collator对象。 Collector.Characteristics 指示 Collector特性的特性，可用于优化缩减实现。 CompactDecimalFormat.CompactStyle CompactDecimalFormat的样式参数。 ComponentName 标识符为特定的应用程序组件（ Activity ， Service ， BroadcastReceiver ，或 ContentProvider可用）。 Configuration 该类描述可能影响应用程序检索资源的所有设备配置信息。 ConsoleMessage.MessageLevel   CopticCalendar 实施科普特日历系统。 CryptoPrimitive 枚举密码原语。 Currency.CurrencyUsage 用于十进制格式的货币使用情况 CursorJoiner.Result 对next（）的调用的结果。 Date 类 Date代表一个特定的时间点，具有毫秒精度。 DateFormat.BooleanAttribute 布尔属性 Delayed 混合式界面用于标记在给定延迟后应该执行的对象。 DialogPreference 基于对话框的 Preference对象的基类。 DisplayContext 显示上下文设置。 DisplayContext.Type 键入DisplayContext的值 Double Double类将原始类型 double的值包装在对象中。 DoubleBuffer 双缓冲区。 DropDownPreference 版本 ListPreference ，在下拉菜单中显示选项，而不是对话框。 EditTextPreference 一个允许字符串输入的 Preference 。 Element.DataKind 必要时对数据进行特殊解释。 Element.DataType DataType表示基本元素的基本类型信息。 ElementType 程序元素类型。 Enum<E extends Enum<E>> 这是所有Java语言枚举类型的通用基类。 File 文件和目录路径名的抽象表示。 Float Float类将原始类型 float的值包装在对象中。 FloatBuffer 一个浮点缓冲区。 Formatter.BigDecimalLayoutForm   GradientDrawable.Orientation 控制渐变相对于可绘制边界的方向 GregorianCalendar [icu增强] ICU的替代GregorianCalendar 。 ICU特有的方法，字段和其他功能标记为“ [icu] ”。 HebrewCalendar HebrewCalendar是实现传统希伯来日历的 Calendar的子类。 IDNA.Error IDNA错误位设置值。 ImageView.ScaleType 将图像边界缩放到此视图边界的选项。 IndianCalendar IndianCalendar是的子类 GregorianCalendar ，因为佛的诞生是数年。 IntBuffer 一个int缓冲区。 Integer Integer类将原始类型 int的值包装在对象中。 Interpolator.Result   IslamicCalendar IslamicCalendar是实现伊斯兰民间和宗教日历的 Calendar的子类。 IslamicCalendar.CalculationType 枚举可用的日历计算类型 JapaneseCalendar JapaneseCalendar是 JapaneseCalendar的一个子类，它以日本帝王统治时期的年代和 GregorianCalendar为数字。 JsonToken JSON编码字符串中的结构，名称或值类型。 KeyRep.Type 密钥类型。 Layout.Alignment   ListPreference 一个 Preference ，它将条目列表显示为对话框。 LocalSocketAddress.Namespace 该地址存在的名称空间。 Locale.Category 枚举语言环境类别。 LocaleDisplayNames.DialectHandling Enum用于 getInstance(ULocale, DialectHandling) 。 Long Long类将原始类型 long的值包装在对象中。 LongBuffer 很长的缓冲区。 MappedByteBuffer 直接字节缓冲区，其内容是文件的内存映射区域。 Matrix.ScaleToFit 控制src rect如何对齐setRectToRect（）的dst矩形。 MeasureFormat.FormatWidth 格式化宽度枚举。 MessagePattern.ApostropheMode 当撇号开始引用MessageFormat输出的文字文本时的模式。 MessagePattern.ArgType 参数类型常量。 MessagePattern.Part.Type 部件类型常量。 MultiSelectListPreference 一个 Preference ，它将条目列表显示为对话框。 NetworkInfo.DetailedState 网络连接的细粒度状态。 NetworkInfo.State 粗粒度的网络状态。 Normalizer.Form 此枚举提供 Unicode Standard Annex #15 — Unicode Normalization Forms中描述的四种Unicode规范化形式的 常量以及两种访问它们的方法。 Normalizer2.Mode 标准化模式的常量。 NumericShaper.Range A NumericShaper.Range表示具有其自己的十进制数字的脚本的Unicode范围。 ObjectStreamField Serializable类的Serializable字段的描述。 PKIXReason PKIXReason列举了根据PKIX（RFC 3280）标准，X.509认证路径可能无效的潜在PKIX特定原因。 PKIXRevocationChecker.Option 可以为撤销检查机制指定各种撤销选项。 Paint.Align 对齐指定drawText如何将文本相对于[x，y]坐标对齐。 Paint.Cap Cap规定了描边线和路径的开始和结束的处理。 Paint.Join 连接指定线条和曲线段在描边路径上连接的处理。 Paint.Style 样式指定正在绘制的图元是填充，描边还是两者（以相同颜色）。 Path.Direction 指定封闭形状（例如， Path.FillType 枚举路径可能被填充的方式。 Path.Op 组合两条路径时可以执行的逻辑操作。 PathDashPathEffect.Style   PluralRules.PluralType 复数类型和PluralRules。 PorterDuff.Mode   Preference 表示由显示的基本偏好UI积木 PreferenceActivity在一个形式 ListView 。 PreferenceCategory 用于将 Preference对象分组，并在组上方提供禁用的标题。 PreferenceGroup 一个容器，用于多个 Preference对象。 PreferenceScreen 表示首选 Preference ，它是首选项层次结构的根。 Proxy.Type 代表代理类型。 Rational 一个不可变的数据类型表示有理数。 Region.Op   RelativeDateTimeFormatter.AbsoluteUnit 代表一个绝对单位。 RelativeDateTimeFormatter.Direction 代表绝对单位的方向，例如“下周二”或“上周二” RelativeDateTimeFormatter.RelativeUnit 表示格式化相对日期的单位。 RelativeDateTimeFormatter.Style 格式化风格 RenderScript.ContextType ContextType指定要创建的特定上下文类型。 RenderScript.Priority RenderScript工作线程优先级枚举。 RetentionPolicy 注释保留策略。 RingtonePreference 一个允许用户从设备上选择铃声的 Preference 。 RoundingMode 指定结果不能完全表示的操作的舍入行为。 RowIdLifetime 枚举RowId生命周期值。 RunnableScheduledFuture<V> ScheduledFuture即 Runnable 。 SSLEngineResult.HandshakeStatus 描述当前 SSLEngine握手状态的 SSLEngineResult枚举。 SSLEngineResult.Status 描述 SSLEngine操作的总体结果的 SSLEngineResult枚举。 Sampler.Value   ScheduledFuture<V> 可以取消的延迟结果支持动作。 SearchIterator.ElementComparisonType 控制比较元素比较方式的选项。 Shader.TileMode   Short Short类将原始类型 short的值包装在对象中。 ShortBuffer 一个短缓冲区。 SmsMessage.MessageClass 此枚举在API级别4中已弃用。使用android.telephony.SmsMessage。 StandardProtocolFamily 定义通信协议的标准系列。 String String类表示字符串。 SupplicantState 来自 defs.h的 wpa_supplicant 。 SwitchPreference 一个 Preference ，提供了一个双态切换选项。 SwitchPreferenceCompat 提供双态切换选项的 Preference 。 TaiwanCalendar TaiwanCalendar是自1912年以来的数字年的 GregorianCalendar的子类。 TextKeyListener.Capitalize   TextUtils.TruncateAt   TextView.BufferType   Thread.State 线程状态。 Time 围绕java.util.Date类的薄包装器，它允许JDBC API将其标识为SQL TIME值。 TimeUnit A TimeUnit表示给定粒度单位的持续时间，并提供实用方法以跨单位进行转换，并在这些单位中执行计时和延迟操作。 TimeZone.SystemTimeZoneType [icu] getAvailableIDs(SystemTimeZoneType, String, Integer)的过滤区域使用的系统时区类型常量 TimeZoneFormat.GMTOffsetPatternType 偏移模式类型枚举。 TimeZoneFormat.ParseOption 解析选项枚举，用于指定可选的解析行为。 TimeZoneFormat.Style 格式/解析API在 TimeZoneFormat使用的时区显示格式样式枚举。 TimeZoneFormat.TimeType 时间类型枚举用于接收 TimeZoneFormat API中的时间类型（标准时间，日光时间或未知）。 TimeZoneNames.NameType 时区显示名称类型 Timestamp 一个围绕java.util.Date的薄包装，允许JDBC API将其标识为SQL TIMESTAMP值。 TwoStatePreference 具有两种可选状态的首选项的公共基类，在SharedPreferences中保留布尔值，并且可能具有根据当前状态启用/禁用的相关首选项。 Type.CubemapFace   ULocale [icu增强] ICU的替代Locale 。 ICU特有的方法，字段和其他功能标记为“ [icu] ”。 ULocale.Category 枚举语言环境类别。 URI 表示统一资源标识符（URI）参考。 UScript.ScriptUsage 脚本使用常量。 UUID 表示不可变的通用唯一标识符（UUID）的类。 UnicodeSet 一组可变的Unicode字符和多字符字符串。 UnicodeSet.ComparisonStyle 比较样式枚举由 compareTo(UnicodeSet, ComparisonStyle) 。 UnicodeSet.SpanCondition 包含当前字符时span（）和类似函数是否继续的参数值与 UnicodeSetSpanner.CountMethod replaceFrom和countIn选项用于控制如何处理每个匹配的跨度。 UnicodeSetSpanner.TrimOption trim（）方法的选项 Uri 不可变的URI引用。 VersionInfo 用于存储形式major.minor.milli.micro的版本号的类。 ViewDebug.HierarchyTraceType 此枚举在API级别16中已弃用。此枚举现在未使用 ViewDebug.RecyclerTraceType 此枚举在API级别16中已弃用。此枚举现在未使用 WebSettings.LayoutAlgorithm 枚举控制html的布局。 WebSettings.PluginState 插件状态影响插件在页面上的处理方式。 WebSettings.RenderPriority   WebSettings.TextSize 此枚举在API级别14中已弃用。请改用setTextZoom(int)和getTextZoom() 。 WebSettings.ZoomDensity 枚举用于指定WebView的所需密度。 Xml.Encoding 支持的字符编码。

该接口对每个实现它的类的对象进行总排序。 这种排序被称为类的自然排序 ，类的compareTo的方法，只要它的自然比较方法提及。

实现此接口的对象的列表（和数组）可以由Collections.sort （和Arrays.sort ）自动排序。 实现该接口的对象，可以使用如在键sorted map或作为在元件sorted set ，而不需要指定一个comparator 。

当且仅当e1.compareTo(e2) == 0的e1和e2类别C的布尔值与e1.equals(e2)的布尔值具有相同的布尔值时， C类的自然排序才被认为与等于一致 。 请注意， null不是任何类的实例， e.compareTo(null)应该抛出NullPointerException，即使e.equals(null)返回false 。

强烈建议（但不要求）自然排序与平等一致。 这是因为排序集合（和排序映射）没有显式比较器时，它们与自然排序与equals不一致的元素（或键）一起使用时表现得“奇怪”。 特别是，这样一个有序集合（或有序映射）违反了集合（或映射）的一般契约，这是根据equals方法定义的。

例如，如果添加两个键 a和 b ，使得 (!a.equals(b) && a.compareTo(b) == 0)对于不使用显式比较器的有序集合，则第二个 add操作返回false（并且有序集合的大小不会增加），因为 a和 b是等效的从排序集的角度来看。

几乎所有实现了Comparable的 Java核心类都具有与平等一致的自然排序。 一个例外是java.math.BigDecimal ，其自然排序等同于具有相同值和不同精度（例如4.0和4.00）的BigDecimal对象。

对于数学上倾斜的，定义给定类C的自然排序的 关系是：

       {(x, y) such that x.compareTo(y) <= 0}.
 

       {(x, y) such that x.compareTo(y) == 0}.
 

     {(x, y) such that x.equals(y)}. 

该界面是 Java Collections Framework的成员。

Summary

Public methods

int compareTo (T o)