java.lang

Взаимодействуйте через интерфейс Сопоставимый <T>

Введите Параметры:

T - тип объектов, по сравнению с которыми может быть этот объект

Все Известные Подынтерфейсы:

Задержанный, Имя, Путь, RunnableScheduledFuture <V>, ScheduledFuture <V>

Все Известные Классы с реализацией:

AbstractRegionPainter.PaintContext.CacheMode, AccessMode, AclEntryFlag, AclEntryPermission, AclEntryType, AddressingFeature. Ответы, Аутентификатор. RequestorType, BigDecimal, BigInteger, Булевская переменная, Байт, ByteBuffer, Календарь, CertPathValidatorException. Бэзикрисон, Символ, Символ. UnicodeScript, CharBuffer, Набор символов, ClientInfoStatus, CollationKey, Компонент. BaselineResizeBehavior, CompositeName, CompoundName, КРЛРИСОН, CryptoPrimitive, Дата, Дата, Рабочий стол. Действие, Диагностика. Вид, Диалоговое окно. ModalExclusionType, Диалоговое окно. ModalityType, дважды, DoubleBuffer, DropMode, ElementKind, ElementType, Перечисление, Файл, FileTime, FileVisitOption, FileVisitResult, Плавание, FloatBuffer, Средство форматирования. BigDecimalLayoutForm, FormSubmitEvent. MethodType, GraphicsDevice. WindowTranslucency, GregorianCalendar, GroupLayout. Выравнивание, IntBuffer, Целое число, JavaFileObject. Вид, JTable. PrintMode, KeyRep. Тип, LayoutStyle. ComponentPlacement, LdapName, LinkOption, Локаль. Категория, Долго, LongBuffer, MappedByteBuffer, MemoryType, MessageContext. Контекст, Модификатор, MultipleGradientPaint. ColorSpaceType, MultipleGradientPaint. CycleMethod, NestingKind, Normalizer. Форма, NumericShaper. Диапазон, ObjectName, ObjectStreamField, ПКИКСРИСОН, PosixFilePermission, ProcessBuilder. Перенаправление. Введите, Прокси. Тип, PseudoColumnUsage, Rdn, Ресурс. AuthenticationType, RetentionPolicy, RoundingMode, RowFilter. ComparisonType, RowIdLifetime, RowSorterEvent. Введите, Служба. Режим, Короткий, ShortBuffer, SOAPBinding. ParameterStyle, SOAPBinding. Стиль, SOAPBinding. Использование, SortOrder, SourceVersion, SSLEngineResult. HandshakeStatus, SSLEngineResult. Состояние, StandardCopyOption, StandardLocation, StandardOpenOption, StandardProtocolFamily, Строка, SwingWorker. StateValue, Поток. Государство, Время, Метка времени, TimeUnit, TrayIcon. MessageType, TypeKind, URI, UUID, WebParam. Режим, Окно. Тип, XmlAccessOrder, XmlAccessType, XmlNsForm

public interface Comparable<T>

Этот интерфейс налагает полное упорядочивание на объекты каждого класса, который реализует его. Это упорядочивание упоминается как естественное упорядочивание класса, и метод compareTo класса упоминается как его естественный метод сравнения.

Списки (и массивы) объектов, которые реализуют этот интерфейс, могут быть сортированы автоматически Collections.sort (и Arrays.sort). Объекты, которые реализуют этот интерфейс, могут использоваться в качестве ключей в сортированной карте или в качестве элементов в сортированном наборе без потребности определить компаратор.

Естественное упорядочивание для класса, с которым C, как говорят, является непротиворечивым, равняется, если и только если у e1.compareTo(e2) == 0 есть то же самое булево значение как e1.equals(e2) для каждого e1 и e2 класса C. Отметьте, что null не является экземпляром любого класса, и e.compareTo(null) должен бросить NullPointerException даже при том, что e.equals(null) возвращает false.

Это строго рекомендуется (хотя не требуемый), с которым естественные упорядочивания являются непротиворечивыми, равняется. Это так, потому что сортированные наборы (и сортированные карты) без явных компараторов ведут себя "странно", когда они используются с элементами (или ключи), чье естественное упорядочивание непоследовательно с, равняется. В частности такой сортированный набор (или сортированная карта) нарушает общий контракт для набора (или карта), который определяется с точки зрения метода equals.

Например, если Вы добавляете два ключа a и b так, что (!a.equals(b) && a.compareTo(b) == 0) к сортированному набору, который не использует явный компаратор, вторая работа add возвращает false (и размер сортированного набора не увеличивается), потому что a и b эквивалентны с точки зрения сортированного набора.

Фактически у всех классов ядра Java, которые реализуют Comparable, есть естественные упорядочивания, которые являются непротиворечивыми с, равняется. Одним исключением является java.math.BigDecimal, естественное упорядочивание которого приравнивает объекты BigDecimal с равными значениями и различной точностью (такой как 4.0 и 4.00).

Для математически наклоненного, отношение, которое определяет естественное упорядочивание на данном классе C:

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

Частное для этого полного порядка:

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

Это сразу следует из контракта для compareTo, что частное является отношением эквивалентности на C, и что естественное упорядочивание является полным порядком на C. То, когда мы говорим, что естественное упорядочивание класса является непротиворечивым с, равняется, мы подразумеваем, что частное для естественного упорядочивания является отношением эквивалентности, определенным классом equals(Object) метод:

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

Этот интерфейс является элементом Платформы Наборов Java.

С тех пор:

1.2

См. Также:

Comparator

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
int	compareTo(T o) Сравнивает этот объект с указанным объектом для порядка.

Деталь метода

compareTo

int compareTo(T o)

Сравнивает этот объект с указанным объектом для порядка. Возвращает отрицательное целое число, нуль, или положительное целое число, поскольку этот объект является меньше чем, равный, или больше чем указанный объект.

Конструктор должен гарантировать sgn(x.compareTo(y)) == -sgn(y.compareTo(x)) для всего x и y. (Это подразумевает, что x.compareTo(y) должен бросить эквивалентность исключения, y.compareTo(x) выдает исключение.)

Конструктор должен также гарантировать, что отношение является переходным: (x.compareTo(y)>0 && y.compareTo(z)>0) подразумевает x.compareTo(z)>0.

Наконец, конструктор должен гарантировать, что x.compareTo(y)==0 подразумевает что sgn(x.compareTo(z)) == sgn(y.compareTo(z)) для всего z.

Это строго рекомендуется, но не строго требуемое тот (x.compareTo(y)==0) == (x.equals(y)). Вообще говоря, любой класс, который реализует Comparable, взаимодействует через интерфейс, и нарушает это условие, должен ясно указать на этот факт. Рекомендуемый язык является "Примечанием: у этого класса есть естественное упорядочивание, которое непоследовательно с, равняется."

В предшествующем описании нотации sgn( expression) определяет математическую сигнум-функцию, которая определяется, чтобы возвратить один из -1, 0, или 1 согласно тому, отрицательно ли значение выражения, нуль или положительно.

Параметры:

o - объект, который будет сравнен.

Возвраты:

отрицательное целое число, нуль, или положительное целое число как этот объект являются меньше чем, равный, или больше чем указанный объект.

Броски:

NullPointerException - если указанный объект является нулем

ClassCastException - если тип указанного объекта препятствует тому, чтобы это было по сравнению с этим объектом.