src.it.unimi.dsi.util.Intervals Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of dsiutils Show documentation

The DSI utilities are a mishmash of classes accumulated during the last twenty years in projects developed at the DSI (Dipartimento di Scienze dell'Informazione, i.e., Information Sciences Department), now DI (Dipartimento di Informatica, i.e., Informatics Department), of the Universita` degli Studi di Milano.

There is a newer version: 2.7.3

Show newest version

/*
 * DSI utilities
 *
 * Copyright (C) 2003-2020 Paolo Boldi and Sebastiano Vigna
 *
 *  This library is free software; you can redistribute it and/or modify it
 *  under the terms of the GNU Lesser General Public License as published by the Free
 *  Software Foundation; either version 3 of the License, or (at your option)
 *  any later version.
 *
 *  This library is distributed in the hope that it will be useful, but
 *  WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 *  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License
 *  for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public License
 *  along with this program; if not, see .
 *
 */

package it.unimi.dsi.util;

import java.util.Comparator;


/** A class providing static methods and objects that do useful things with intervals.
 *
 * @see Interval
 */

public class Intervals {

	private Intervals() {}

	public static final Interval[] EMPTY_ARRAY = {};

	/** An empty (singleton) interval. */
	public static final Interval EMPTY_INTERVAL = new Interval(1, 0);

	/** A singleton located at −∞. */
	public static final Interval MINUS_INFINITY = new Interval(Integer.MIN_VALUE, Integer.MIN_VALUE);

	/** A comparator between intervals defined as follows:
	 * [a..b] is less than [a'..b'] iff
	 * the first interval starts before or prolongs the second one, that is,
	 * iff a < a' or a=a' and b' < b.
	 */
	public static final Comparator STARTS_BEFORE_OR_PROLONGS = (i1, i2) -> {
		final int t = Integer.compare(i1.left, i2.left);
		if (t != 0) return t;
		return Integer.compare(i2.right, i1.right);
	};

	/** A comparator between intervals defined as follows:
	 * [a..b] is less than [a'..b'] iff
	 * the first interval ends before or is a suffix of the second one, that is,
	 * iff b < b' or b=b' and a' < a.
	 */
	public static final Comparator ENDS_BEFORE_OR_IS_SUFFIX = (i1, i2) -> {
		final int t = Integer.compare(i1.right, i2.right);
		if (t != 0) return t;
		return Integer.compare(i2.left, i1.left);
	};

	/** A comparator between intervals defined as follows:
	 * [a..b] is less than [a'..b']
	 * iff the first interval starts after the second one, that is,
	 * iff a' < a.
	 */
	public static final Comparator STARTS_AFTER = (i1, i2) -> Integer.compare(i2.left, i1.left);

	/** A comparator between intervals defined as follows:
	 * [a..b] is less than [a'..b']
	 * iff the first interval starts before the second one, that is,
	 * iff a < a'.
	 */
	public static final Comparator STARTS_BEFORE = (i1, i2) -> Integer.compare(i1.left, i2.left);

	/** A comparator between intervals defined as follows:
	 * [a..b] is less than [a'..b']
	 * iff the first interval ends after the second one, that is,
	 * iff b' < b.
	 */
	public static final Comparator ENDS_AFTER = (i1, i2) -> Integer.compare(i2.right, i1.right);

	/** A comparator between intervals defined as follows:
	 * [a..b] is less than [a'..b']
	 * iff the first interval ends before the second one, that is,
	 * iff b < b'.
	 */
	public static final Comparator ENDS_BEFORE = (i1, i2) -> Integer.compare(i1.right, i2.right);

	/** A comparator between intervals based on their length. */
	public static final Comparator LENGTH_COMPARATOR = (i1, i2) -> Integer.compare(i1.length(), i2.length());
}