Class Range

output/java_guava/1.4.18/Range.java:112–740

A range (or "interval") defines the boundaries around a contiguous span of values of some Comparable type; for example, "integers from 1 to 100 inclusive." Note that it is not possible to iterate over these contained values. To do so, pass this range instance and an appropriate

@GwtCompatible
@SuppressWarnings("rawtypes")
public final class Range<C extends Comparable> implements Predicate<C>, Serializable {
  private static final Function<Range, Cut> LOWER_BOUND_FN = new Function<Range, Cut>() {
                                                               @Override
                                                               public Cut apply(Range range) {
                                                                 return range.lowerBound;
                                                               }
                                                             };

  @SuppressWarnings("unchecked")
  static <C extends Comparable<?>> Function<Range<C>, Cut<C>> lowerBoundFn() {
    return (Function) LOWER_BOUND_FN;
  }

  private static final Function<Range, Cut> UPPER_BOUND_FN = new Function<Range, Cut>() {
                                                               @Override
                                                               public Cut apply(Range range) {
                                                                 return range.upperBound;
                                                               }
                                                             };

  @SuppressWarnings("unchecked")
  static <C extends Comparable<?>> Function<Range<C>, Cut<C>> upperBoundFn() {
    return (Function) UPPER_BOUND_FN;
  }


  static final Ordering<Range<?>> RANGE_LEX_ORDERING = new RangeLexOrdering();

  static <C extends Comparable<?>> Range<C> create(Cut<C> lowerBound, Cut<C> upperBound) {
    return new Range<C>(lowerBound, upperBound);
  }

  /**
   * Returns a range that contains all values strictly greater than {@code
   * lower} and strictly less than {@code upper}.
   *
   * @throws IllegalArgumentException if {@code lower} is greater than <i>or
   *     equal to</i> {@code upper}
   * @since 14.0
   */


  public static <C extends Comparable<?>> Range<C> open(C lower, C upper) {
    return create(Cut.aboveValue(lower), Cut.belowValue(upper));
  }

  /**
   * Returns a range that contains all values greater than or equal to
   * {@code lower} and less than or equal to {@code upper}.
   *
   * @throws IllegalArgumentException if {@code lower} is greater than {@code
   *     upper}
   * @since 14.0
   */