ISortedMap 接口

定义

[Android.Runtime.Register("java/util/SortedMap", "", "Java.Util.ISortedMapInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public interface ISortedMap : IDisposable, Java.Interop.IJavaPeerable, Java.Util.IMap

[Android.Runtime.Register("java/util/SortedMap", "", "Java.Util.ISortedMapInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public interface ISortedMap : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ISequencedMap

[<Android.Runtime.Register("java/util/SortedMap", "", "Java.Util.ISortedMapInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type ISortedMap = interface
    interface IMap
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

[<Android.Runtime.Register("java/util/SortedMap", "", "Java.Util.ISortedMapInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type ISortedMap = interface
    interface IMap
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ISequencedMap

派生

Java.Util.INavigableMap

Java.Util.TreeMap

属性

RegisterAttribute JavaTypeParametersAttribute

实现

IJavaObject IJavaPeerable IMap IDisposable ISequencedMap

注解

它 Map 进一 <步在其键上提供 em>total ordering</em> 。 地图按键的“可比”自然排序顺序进行排序，或者通常按 Comparator 排序的地图创建时间提供。 在循环访问排序地图的集合视图（由entrySetkeySet和values方法返回）时，将反映此顺序。 提供了几个额外的操作来利用排序。 （此接口是 SortedSet.）

插入到排序映射中的所有键都必须实现 Comparable 接口（或由指定的比较器接受）。 此外，所有此类键都必须是<>相互比较<的/em>： k1.compareTo(k2) （或comparator.compare(k1, k2)）不得为任何键ClassCastException和k1已排序的映射引发。k2 尝试违反此限制将导致有问题的方法或构造函数调用引发 。ClassCastException

请注意，如果排序的映射正确实现<接口，则排序映射（是否提供显式比较器）所维护的顺序必须与>< equals>/emMap 一致。 （有关与 equalsComparable/emComparator 一致的 em<的精确定义>，请参阅<接口或>接口）这是因为Map接口在操作方面equals进行了定义，但已排序的映射使用其 compareTo （或compare） 方法执行所有键比较，因此此方法认为相等的两个键从排序的映射的角度来看是相等的。 即使树状图 em 的行为与相等不一致，树状图 <em>的行为也<>定义良好;它只是不服从接口的Map一般协定。

所有常规用途排序映射实现类都应提供四个“标准”构造函数。 尽管接口无法指定所需的构造函数，但无法强制实施此建议。 所有排序映射实现的预期“标准”构造函数为：<ol><li>A void（无参数）构造函数，该构造函数根据键的自然顺序创建一个按其自然排序的空排序映射。</li li><>A 构造函数具有一个类型Comparator参数，它根据指定的比较器创建一个空排序映射。</li li><>A 构造函数，其类型Map为一个参数，该构造函数使用与其参数相同的键值映射创建一个新映射，根据键的自然排序进行排序。</li li><>A 构造函数，其类型SortedMap为单个参数，该构造函数使用与输入排序映射相同的键值映射和相同的排序方式创建一个新的排序映射。</li></ol>

<strong Note>/strong<>：几种方法返回具有受限键范围的子映射。 此类范围是 <em>半开放</em>，即它们包括其低终结点，但不包括其高终结点（如果适用）。 如果需要 em<封闭范围>/em<（包括两个>终结点），并且密钥类型允许计算给定密钥的后续任务，只需从中lowEndpointsuccessor(highEndpoint)请求子范围即可。 例如，假设 m 这是一个映射，其键是字符串。 以下成语获取一个视图，其中包含其键介于m和low（含）之间的所有键值映射high：

SortedMap<String, V> sub = m.subMap(low, high+"\0");

类似的技术可用于生成 em<开放范围>/em<（不包含两个>终结点）。 以下成语获取一个视图，其中包含其键介于m和low独占之间的所有键值映射high：

SortedMap<String, V> sub = m.subMap(low+"\0", high);

此接口是 Java 集合框架的成员。

已在 1.2 中添加。

适用于 . 的 java.util.SortedMapJava 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。