モジュール java.base

パッケージ java.lang

インタフェースComparable<T>

型パラメータ:

T - このオブジェクトが比較されるオブジェクトの型

既知のすべてのサブインタフェース:

AnnotationTypeDoc, AnnotationTypeElementDoc, ArrayType, ByteValue, CharValue, ChronoLocalDate, ChronoLocalDateTime<D>, Chronology, ChronoZonedDateTime<D>, ClassDoc, ClassType, ConstructorDoc, Delayed, Doc, DoubleValue, ExecutableMemberDoc, Field, FieldDoc, FloatValue, IntegerValue, InterfaceType, LocalVariable, Location, LongValue, MemberDoc, Method, MethodDoc, Name, PackageDoc, Path, ProcessHandle, ProgramElementDoc, ReferenceType, RootDoc, RunnableScheduledFuture<V>, ScheduledFuture<V>, SerialFieldTag, ShortValue

既知のすべての実装クラス:

AbstractChronology, AbstractRegionPainter.PaintContext.CacheMode, AccessibleAction, AccessibleAttribute, AccessibleRole, AccessMode, AclEntryFlag, AclEntryPermission, AclEntryType, AddressingFeature.Responses, Alert.AlertType, Animation.Status, ArcType, AssociationChangeNotification.AssocChangeEvent, AttributeTree.ValueKind, Authenticator.RequestorType, BackgroundRepeat, BigDecimal, BigInteger, BlendMode, BlurType, Boolean, BorderRepeat, ButtonBar.ButtonData, Byte, ByteBuffer, CacheHint, Calendar, CardTerminals.State, CatalogFeatures.Feature, CertPathValidatorException.BasicReason, Character, Character.UnicodeScript, CharBuffer, Charset, ChronoField, ChronoUnit, ClientInfoStatus, Collation, CollationKey, Collector.Characteristics, Component.BaselineResizeBehavior, CompositeName, CompoundName, ConditionalFeature, ContentDisplay, ConversionComparator.Comparison, CRLReason, CryptoPrimitive, CullFace, CycleMethod, Date, Date, DayOfWeek, DepthTest, Desktop.Action, Diagnostic.Kind, Diagnostic.Kind, Dialog.ModalExclusionType, Dialog.ModalityType, Doclet.Option.Kind, DocletEnvironment.ModuleMode, DocTree.Kind, DocumentationTool.Location, Double, DoubleBuffer, DrawMode, DrbgParameters.Capability, DropMode, Duration, Duration, ElementKind, Elements.Origin, ElementType, Enum, File, FileTime, FileVisitOption, FileVisitResult, FillRule, Float, FloatBuffer, FocusEvent.Cause, FontPosture, FontSmoothingType, FontWeight, FormatStyle, Formatter.BigDecimalLayoutForm, FormSubmitEvent.MethodType, GraphicsDevice.WindowTranslucency, GregorianCalendar, GroupLayout.Alignment, HandlerResult, HijrahChronology, HijrahDate, HijrahEra, HorizontalDirection, HPos, HTMLEditorSkin.Command, HttpClient.Redirect, HttpClient.Version, InputMethodHighlight, InquireType, Instant, IntBuffer, Integer, IsoChronology, IsoEra, JapaneseChronology, JapaneseDate, JavaFileObject.Kind, JConsoleContext.ConnectionState, JDBCType, JTable.PrintMode, KeyCode, KeyCombination.ModifierValue, KeyRep.Type, LambdaExpressionTree.BodyKind, LanguageVersion, LayoutStyle.ComponentPlacement, LdapName, LineChart.SortingPolicy, LinkOption, LocalDate, LocalDateTime, Locale.Category, Locale.FilteringMode, Locale.IsoCountryCode, LocalTime, Long, LongBuffer, MappedByteBuffer, Match, MatrixType, MediaException.Type, MediaPlayer.Status, MemberReferenceTree.ReferenceMode, MemoryType, MessageContext.Scope, MinguoChronology, MinguoDate, MinguoEra, Modality, Modifier, ModuleDescriptor, ModuleDescriptor.Exports, ModuleDescriptor.Exports.Modifier, ModuleDescriptor.Modifier, ModuleDescriptor.Opens, ModuleDescriptor.Opens.Modifier, ModuleDescriptor.Provides, ModuleDescriptor.Requires, ModuleDescriptor.Requires.Modifier, ModuleDescriptor.Version, ModuleElement.DirectiveKind, ModuleTree.ModuleKind, Month, MonthDay, MouseButton, MultipleGradientPaint.ColorSpaceType, MultipleGradientPaint.CycleMethod, NestingKind, NodeOrientation, Normalizer.Form, NumericShaper.Range, ObjectInputFilter.Status, ObjectName, ObjectStreamField, OffsetDateTime, OffsetTime, Orientation, OverrunStyle, PageOrientation, PathTransition.OrientationType, PeerAddressChangeNotification.AddressChangeEvent, PixelFormat.Type, PKIXReason, PKIXRevocationChecker.Option, PopupWindow.AnchorLocation, Pos, PosixFilePermission, Preloader.StateChangeNotification.Type, PrintColor, Printer.MarginType, PrinterJob.JobStatus, PrintQuality, PrintSides, Priority, ProcessBuilder.Redirect.Type, Proxy.Type, PseudoColumnUsage, QuitStrategy, Rdn, RecordingState, ResolverStyle, Resource.AuthenticationType, ResourceAccuracy, RetentionPolicy, RoundingMode, RowFilter.ComparisonType, RowIdLifetime, RowSorterEvent.Type, Runtime.Version, ScrollEvent.HorizontalTextScrollUnits, ScrollEvent.VerticalTextScrollUnits, ScrollPane.ScrollBarPolicy, SelectionMode, Service.Mode, Short, ShortBuffer, Side, SignStyle, SizeUnits, Snippet.Kind, Snippet.Status, Snippet.SubKind, SOAPBinding.ParameterStyle, SOAPBinding.Style, SOAPBinding.Use, SocketFlow.Status, SortOrder, SourceCodeAnalysis.Completeness, SourceVersion, SSLEngineResult.HandshakeStatus, SSLEngineResult.Status, StackWalker.Option, StageStyle, StandardCopyOption, StandardLocation, StandardNamespace, StandardOpenOption, StandardOperation, StandardProtocolFamily, String, StrokeLineCap, StrokeLineJoin, StrokeType, StyleOrigin, SwingWorker.StateValue, System.Logger.Level, TableColumn.SortType, TabPane.TabClosingPolicy, Taglet.Location, Taskbar.Feature, Taskbar.State, TaskEvent.Kind, TextAlignment, TextBoundsType, TextInputControlSkin.Direction, TextInputControlSkin.TextUnit, TextStyle, ThaiBuddhistChronology, ThaiBuddhistDate, ThaiBuddhistEra, Thread.State, Time, Timestamp, TimeUnit, TouchPoint.State, TransferMode, TrayIcon.MessageType, Tree.Kind, Tree.Kind, TreeSortMode, TreeTableColumn.SortType, TypeKind, URI, UserSessionEvent.Reason, UUID, VarHandle.AccessMode, VerticalDirection, VMOption.Origin, VPos, WebParam.Mode, WebSocket.MessagePart, Window.Type, Worker.State, XmlAccessOrder, XmlAccessType, XmlNsForm, XPathEvaluationResult.XPathResultType, Year, YearMonth, ZonedDateTime, ZoneOffset, ZoneOffsetTransition, ZoneOffsetTransitionRule.TimeDefinition

public interface Comparable<T>

このインタフェースを実装する各クラスのオブジェクトに全体順序付けを強制します。 この順序付けはクラスの自然順序付けと呼ばれ、このクラスのcompareToメソッドは自然比較メソッドと呼ばれます。

このインタフェースを実装するオブジェクトのリスト(および配列)は、Collections.sort (およびArrays.sort)によって自動的にソートできます。 このインタフェースを実装するオブジェクトはソート・マップのキーとして使用したり、ソート・セットの要素として使用したりできますが、その際に、コンパレータを指定する必要はありません。

クラスCの自然順序付けがequalsと一貫性があると言われるのは、クラスCのすべてのe1とe2について、e1.compareTo(e2)== 0とe1.equals(e2)のboolean値が同じになる場合だけです。 nullはいずれのクラスのインスタンスでもないため、e.equals(null)がfalseを返す場合でもe.compareTo(null)はNullPointerExceptionをスローすべきです。

自然順序付けでは、equalsと一貫性があることは、必須ではありませんが強く推奨されます。 これは、明示的なコンパレータを指定しないソート・セットやソート・マップを、自然順序付けがequalsと一貫性のない要素またはキーと一緒に使用すると、セットとマップの動作が保証されなくなるからです。 特に、このようなソート・セットまたはソート・マップは、セットまたはマップの一般的な規約に違反します。この規約は、equalsメソッドの用語を用いて定義されています。

たとえば、(!a.equals(b) && a.compareTo(b) == 0)となるような2つのキーaとbを、明示的なコンパレータを使用しないソート・セットに追加する場合、2つ目の追加操作ではfalseが返され、ソート・セットのサイズは増えません。これは、ソート・セットから見るとaとbは等価であるためです。

Comparableを実装するほとんどのJavaコア・クラスは、equalsと一貫性のある自然順序付けを持ちます。 1つの例外は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}.
 

compareToの規約から判断して、商がCで同値関係にあり、自然順序付けがCの全体順序であるということは明らかです。 クラスの自然順序付けがequalsと一貫性があるということは、自然順序付けの商がクラスの次のequals(Object)メソッドで定義される同値関係になることを意味します。

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

このインタフェースは、Java Collections Frameworkのメンバーです。

導入されたバージョン:

1.2

関連項目:

Comparator

メソッドのサマリー

修飾子と型	メソッド	説明
int	compareTo(T o)	このオブジェクトと指定されたオブジェクトの順序を比較します。

メソッドの詳細

compareTo

int compareTo(T o)

このオブジェクトと指定されたオブジェクトの順序を比較します。 このオブジェクトが指定されたオブジェクトより小さい場合は負の整数、等しい場合はゼロ、大きい場合は正の整数を返します。

実装では、すべてのxとyに対してsgn(x.compareTo(y))== -sgn(y.compareTo(x))が保証されなければいけません。 これは、y.compareTo(x)が例外をスローする場合はx.compareTo(y)も例外をスローすることを意味します。

実装者は、関係が推移的であることも保証しなければならない: (x.compareTo(y) > 0 && y.compareTo(z) > 0)はx.compareTo(z) > 0を意味します。

さらに、すべてのzに対してx.compareTo(y)==0がsgn(x.compareTo(z))== sgn(y.compareTo(z))を意味することも保証されなければいけません。

必須というわけではありませんが、(x.compareTo(y)==0)==(x.equals(y))であることが強く推奨されます。 一般に、Comparableインタフェースを実装しているクラスで、この条件に違反するクラスはすべて、明確にこの事実を示す必要があります。 注: このクラスはequalsと一貫性のない自然順序付けを持ちますなどと明示することをお薦めします。

前述の説明において、sgn( expression )は、expressionの値がそれぞれ負、ゼロ、または正であるかどうかに従って、-1、0、または1のうちの1つを返すように定義された数学的signum関数を指定します。

パラメータ:

o -比較対象のオブジェクト。

戻り値:

このオブジェクトが指定されたオブジェクトより小さい場合は負の整数、等しい場合はゼロ、大きい場合は正の整数

例外:

NullPointerException - 指定されたオブジェクトがnullの場合

ClassCastException - 指定されたオブジェクトの型が原因で、このオブジェクトと比較できない場合