summaryrefslogtreecommitdiff
path: root/src/intervals.h
blob: e3441ce0fa34c75953c5356fbc499c5403454ce0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
/***************************************************************************
 *   Copyright (C) 2017-2018 by Hans-Peter Deifel                          *
 *   hpd@hpdeifel.de                                                       *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program 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 General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,      *
 *   Boston, MA 02110-1301 USA.                                            *
 ***************************************************************************/

#ifndef INTERVALS_H
#define INTERVALS_H

#include <vector>
#include <string>

/* This file implements a interval container that supports insertion and
 * inclusion tests for integer intervals.
 *
 * Used for the --page-range feature
 */

struct Interval {
	/* from and to are inclusive. */
	Interval(int from, int to) {
		this->from = from;
		this->to = to;
	}

	int from;
	int to;

	inline bool contains(int element) const {
		return element >= from && element <= to;
	}
};

class IntervalContainer {
public:
	IntervalContainer() {}

	/** Parses a string into intervals.
	 *
	 * This accepts the format used for the --page-range option: A comma
	 * separated list of intervals, which can be either a single integer or
	 * two integers separated by a minus character. Whitespace is not
	 * allowed.
	 *
	 * More precisely, the following grammar is implemented:
	 *
	 * INTERVALS ::= 𝝴 | INTERVAL ',' INTERVALS
	 * INTERVAL  ::= int | int '-' int
	 *
	 */
	static IntervalContainer fromString(const std::string str);

	void addInterval(Interval i);

	/** Returns true if either the element is contained in any interval or
	 * this container is empty.
	 *
	 * The latter case is there to simplify --page-range. If no intervals
	 * are specified, we want to search every page.
	 */
	bool contains(int element) const;

private:
	std::vector<Interval> intervals;
};

#endif /* INTERVALS_H */

/* Local Variables: */
/* mode: c++ */
/* End: */