changeset 1675:1f51277a0357

Documentation for NumRange.
author Robert Casties <casties@mpiwg-berlin.mpg.de>
date Wed, 31 Jan 2018 19:49:49 +0100
parents 699244b75ad3
children fa7855d377a9
files common/src/main/java/digilib/util/NumRange.java
diffstat 1 files changed, 12 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/common/src/main/java/digilib/util/NumRange.java	Tue Dec 05 19:14:55 2017 +0100
+++ b/common/src/main/java/digilib/util/NumRange.java	Wed Jan 31 19:49:49 2018 +0100
@@ -29,6 +29,17 @@
 import java.util.List;
 
 /**
+ * Class that parses String with intervals into Iterable sequence of integers.
+ * <p/>
+ * 
+ * Intervals are separated by comma ','.
+ * An interval is a range represented by two numbers and a hyphen
+ * e.g. "3-6". If the second number is omitted the interval goes to maxnum.
+ * An interval can also consist of a single number e.g. "7".
+ * <p/>
+ * 
+ * Valid NumRanges: "1-10,13-20", "3,5,9", "1-".
+ * 
  * @author casties
  * 
  */
@@ -70,8 +81,7 @@
 
         String intervals[] = pages.split(",");
 
-        // convert the page-interval-strings into a list containing every single
-        // page
+        // convert the page-interval-strings into a list containing every single page
         for (String interval : intervals) {
             if (interval.contains("-")) {
                 String nums[] = interval.split("-");