summaryrefslogtreecommitdiff
path: root/libjava/java/util/SortedMap.java
diff options
context:
space:
mode:
authorAndrew John Hughes <gnu_andrew@member.fsf.org>2004-11-07 11:42:22 +0000
committerMark Wielaard <mark@gcc.gnu.org>2004-11-07 11:42:22 +0000
commit70c67ff596d487c37654ae39e57517da1994723b (patch)
tree474e14b23d1bd5d11263652d5c67abf5d74b01cf /libjava/java/util/SortedMap.java
parentbfda8308a5b52fe6ef8daef7504b4c187fddf2d6 (diff)
2004-11-07 Andrew John Hughes <gnu_andrew@member.fsf.org>
* java/util/Collections.java Added documentation. * java/util/SortedMap.java Clarified some method examples. * java/util/SortedSet.java Clarified some method examples. From-SVN: r90227
Diffstat (limited to 'libjava/java/util/SortedMap.java')
-rw-r--r--libjava/java/util/SortedMap.java23
1 files changed, 12 insertions, 11 deletions
diff --git a/libjava/java/util/SortedMap.java b/libjava/java/util/SortedMap.java
index 742524e7a68..1d2d5a3cc46 100644
--- a/libjava/java/util/SortedMap.java
+++ b/libjava/java/util/SortedMap.java
@@ -97,10 +97,10 @@ public interface SortedMap extends Map
* <p>
*
* The returned map throws an IllegalArgumentException any time a key is
- * used which is out of the range of toKey. Note that the endpoint is not
- * included; if you want the endpoint, pass the successor object in to
- * toKey. For example, for Strings, you can request
- * <code>headMap(limit + "\0")</code>.
+ * used which is out of the range of toKey. Note that the endpoint, toKey,
+ * is not included; if you want this value to be included, pass its successor
+ * object in to toKey. For example, for Integers, you could request
+ * <code>headMap(new Integer(limit.intValue() + 1))</code>.
*
* @param toKey the exclusive upper range of the submap
* @return the submap
@@ -130,9 +130,10 @@ public interface SortedMap extends Map
* The returned map throws an IllegalArgumentException any time a key is
* used which is out of the range of fromKey and toKey. Note that the
* lower endpoint is included, but the upper is not; if you want to
- * change the inclusion or exclusion of an endpoint, pass the successor
- * object in instead. For example, for Strings, you can request
- * <code>subMap(lowlimit + "\0", highlimit + "\0")</code> to reverse
+ * change the inclusion or exclusion of an endpoint, pass its successor
+ * object in instead. For example, for Integers, you could request
+ * <code>subMap(new Integer(lowlimit.intValue() + 1),
+ * new Integer(highlimit.intValue() + 1))</code> to reverse
* the inclusiveness of both endpoints.
*
* @param fromKey the inclusive lower range of the submap
@@ -154,10 +155,10 @@ public interface SortedMap extends Map
* <p>
*
* The returned map throws an IllegalArgumentException any time a key is
- * used which is out of the range of fromKey. Note that the endpoint is
- * included; if you do not want the endpoint, pass the successor object in
- * to fromKey. For example, for Strings, you can request
- * <code>tailMap(limit + "\0")</code>.
+ * used which is out of the range of fromKey. Note that the endpoint, fromKey, is
+ * included; if you do not want this value to be included, pass its successor object in
+ * to fromKey. For example, for Integers, you could request
+ * <code>tailMap(new Integer(limit.intValue() + 1))</code>.
*
* @param fromKey the inclusive lower range of the submap
* @return the submap