Describes a data range given by begin and end index. More...

#include <qcustomplot.h>

Public Member Functions
	QCPDataRange ()

	QCPDataRange (int begin, int end)

bool	operator== (const QCPDataRange &other) const

bool	operator!= (const QCPDataRange &other) const

int	begin () const

int	end () const

int	size () const

int	length () const

void	setBegin (int begin)

void	setEnd (int end)

bool	isValid () const

bool	isEmpty () const

QCPDataRange	bounded (const QCPDataRange &other) const

QCPDataRange	expanded (const QCPDataRange &other) const

QCPDataRange	intersection (const QCPDataRange &other) const

QCPDataRange	adjusted (int changeBegin, int changeEnd) const

bool	intersects (const QCPDataRange &other) const

bool	contains (const QCPDataRange &other) const

	QCPDataRange ()

	QCPDataRange (int begin, int end)

bool	operator== (const QCPDataRange &other) const

bool	operator!= (const QCPDataRange &other) const

int	begin () const

int	end () const

int	size () const

int	length () const

void	setBegin (int begin)

void	setEnd (int end)

bool	isValid () const

bool	isEmpty () const

QCPDataRange	bounded (const QCPDataRange &other) const

QCPDataRange	expanded (const QCPDataRange &other) const

QCPDataRange	intersection (const QCPDataRange &other) const

QCPDataRange	adjusted (int changeBegin, int changeEnd) const

bool	intersects (const QCPDataRange &other) const

bool	contains (const QCPDataRange &other) const

	QCPDataRange ()

	QCPDataRange (int begin, int end)

bool	operator== (const QCPDataRange &other) const

bool	operator!= (const QCPDataRange &other) const

int	begin () const

int	end () const

int	size () const

int	length () const

void	setBegin (int begin)

void	setEnd (int end)

bool	isValid () const

bool	isEmpty () const

QCPDataRange	bounded (const QCPDataRange &other) const

QCPDataRange	expanded (const QCPDataRange &other) const

QCPDataRange	intersection (const QCPDataRange &other) const

QCPDataRange	adjusted (int changeBegin, int changeEnd) const

bool	intersects (const QCPDataRange &other) const

bool	contains (const QCPDataRange &other) const

	QCPDataRange ()

	QCPDataRange (int begin, int end)

bool	operator== (const QCPDataRange &other) const

bool	operator!= (const QCPDataRange &other) const

int	begin () const

int	end () const

int	size () const

int	length () const

void	setBegin (int begin)

void	setEnd (int end)

bool	isValid () const

bool	isEmpty () const

QCPDataRange	bounded (const QCPDataRange &other) const

QCPDataRange	expanded (const QCPDataRange &other) const

QCPDataRange	intersection (const QCPDataRange &other) const

QCPDataRange	adjusted (int changeBegin, int changeEnd) const

bool	intersects (const QCPDataRange &other) const

bool	contains (const QCPDataRange &other) const

	QCPDataRange ()

	QCPDataRange (int begin, int end)

bool	operator== (const QCPDataRange &other) const

bool	operator!= (const QCPDataRange &other) const

int	begin () const

int	end () const

int	size () const

int	length () const

void	setBegin (int begin)

void	setEnd (int end)

bool	isValid () const

bool	isEmpty () const

QCPDataRange	bounded (const QCPDataRange &other) const

QCPDataRange	expanded (const QCPDataRange &other) const

QCPDataRange	intersection (const QCPDataRange &other) const

QCPDataRange	adjusted (int changeBegin, int changeEnd) const

bool	intersects (const QCPDataRange &other) const

bool	contains (const QCPDataRange &other) const

Related Functions
(Note that these are not member functions.)
QDebug	operator<< (QDebug d, const QCPDataRange &dataRange)

Detailed Description

Describes a data range given by begin and end index.

QCPDataRange holds two integers describing the begin (setBegin) and end (setEnd) index of a contiguous set of data points. The end index points to the data point above the last data point that's part of the data range, similarly to the nomenclature used in standard iterators.

Data Ranges are not bound to a certain plottable, thus they can be freely exchanged, created and modified. If a non-contiguous data set shall be described, the class QCPDataSelection is used, which holds and manages multiple instances of QCPDataRange. In most situations, QCPDataSelection is thus used.

Both QCPDataRange and QCPDataSelection offer convenience methods to work with them, e.g. bounded, expanded, intersects, intersection, adjusted, contains. Further, addition and subtraction operators (defined in QCPDataSelection) can be used to join/subtract data ranges and data selections (or mixtures), to retrieve a corresponding QCPDataSelection.

QCustomPlot's data selection mechanism is based on QCPDataSelection and QCPDataRange.

Note: Do not confuse QCPDataRange with QCPRange. A QCPRange describes an interval in floating point plot coordinates, e.g. the current axis range.

Constructor & Destructor Documentation

QCPDataRange::QCPDataRange ( )

Creates an empty QCPDataRange, with begin and end set to 0.

QCPDataRange::QCPDataRange	(	int	begin,
		int	end
	)

Creates a QCPDataRange, initialized with the specified begin and end.

No checks or corrections are made to ensure the resulting range is valid (isValid).

QCPDataRange::QCPDataRange ( )

QCPDataRange::QCPDataRange	(	int	begin,
		int	end
	)

QCPDataRange::QCPDataRange ( )

QCPDataRange::QCPDataRange	(	int	begin,
		int	end
	)

QCPDataRange::QCPDataRange ( )

QCPDataRange::QCPDataRange	(	int	begin,
		int	end
	)

QCPDataRange::QCPDataRange ( )

QCPDataRange::QCPDataRange	(	int	begin,
		int	end
	)

Member Function Documentation

QCPDataRange QCPDataRange::adjusted	(	int	changeBegin,
		int	changeEnd
	)		const

inline

Returns a data range where changeBegin and changeEnd were added to the begin and end indices, respectively.

QCPDataRange QCPDataRange::adjusted	(	int	changeBegin,
		int	changeEnd
	)		const

inline

QCPDataRange QCPDataRange::adjusted	(	int	changeBegin,
		int	changeEnd
	)		const

inline

QCPDataRange QCPDataRange::adjusted	(	int	changeBegin,
		int	changeEnd
	)		const

inline

QCPDataRange QCPDataRange::adjusted	(	int	changeBegin,
		int	changeEnd
	)		const

inline

int QCPDataRange::begin ( void ) const

inline

int QCPDataRange::begin ( void ) const

inline

int QCPDataRange::begin ( ) const

inline

int QCPDataRange::begin ( void ) const

inline

int QCPDataRange::begin ( ) const

inline

QCPDataRange QCPDataRange::bounded ( const QCPDataRange & other ) const

Returns a data range that matches this data range, except that parts exceeding other are excluded.

This method is very similar to intersection, with one distinction: If this range and the other range share no intersection, the returned data range will be empty with begin and end set to the respective boundary side of other, at which this range is residing. (intersection would just return a range with begin and end set to 0.)

QCPDataRange QCPDataRange::bounded ( const QCPDataRange & other ) const

bool QCPDataRange::contains ( const QCPDataRange & other ) const

Returns whether all data points described by this data range are also in other.

See Also: intersects

bool QCPDataRange::contains ( const QCPDataRange & other ) const

int QCPDataRange::end ( void ) const

inline

int QCPDataRange::end ( void ) const

inline

int QCPDataRange::end ( ) const

inline

int QCPDataRange::end ( ) const

inline

int QCPDataRange::end ( void ) const

inline

QCPDataRange QCPDataRange::expanded ( const QCPDataRange & other ) const

Returns a data range that contains both this data range as well as other.

QCPDataRange QCPDataRange::intersection ( const QCPDataRange & other ) const

Returns the data range which is contained in both this data range and other.

This method is very similar to bounded, with one distinction: If this range and the other range share no intersection, the returned data range will be empty with begin and end set to 0. (bounded would return a range with begin and end set to one of the boundaries of other, depending on which side this range is on.)

See Also: QCPDataSelection::intersection

QCPDataRange QCPDataRange::intersection ( const QCPDataRange & other ) const

bool QCPDataRange::intersects ( const QCPDataRange & other ) const

Returns whether this data range and other share common data points.

See Also: intersection, contains

bool QCPDataRange::intersects ( const QCPDataRange & other ) const

bool QCPDataRange::isEmpty ( ) const

inline

bool QCPDataRange::isEmpty ( ) const

inline

Returns whether this range is empty, i.e. whether its begin index equals its end index.

See Also: size, length

bool QCPDataRange::isEmpty ( ) const

inline

bool QCPDataRange::isEmpty ( ) const

inline

bool QCPDataRange::isEmpty ( ) const

inline

bool QCPDataRange::isValid ( ) const

inline

Returns whether this range is valid. A valid range has a begin index greater or equal to 0, and an end index greater or equal to the begin index.

Note: Invalid ranges should be avoided and are never the result of any of QCustomPlot's methods (unless they are themselves fed with invalid ranges). Do not pass invalid ranges to QCustomPlot's methods. The invalid range is not inherently prevented in QCPDataRange, to allow temporary invalid begin/end values while manipulating the range. An invalid range is not necessarily empty (isEmpty), since its length can be negative and thus non-zero.

bool QCPDataRange::isValid ( ) const

inline

bool QCPDataRange::isValid ( ) const

inline

bool QCPDataRange::isValid ( ) const

inline

bool QCPDataRange::isValid ( ) const

inline

int QCPDataRange::length ( ) const

inline

int QCPDataRange::length ( ) const

inline

int QCPDataRange::length ( ) const

inline

int QCPDataRange::length ( ) const

inline

Returns the number of data points described by this data range. Equivalent to size.

int QCPDataRange::length ( ) const

inline

bool QCPDataRange::operator!= ( const QCPDataRange & other ) const

inline

bool QCPDataRange::operator!= ( const QCPDataRange & other ) const

inline

bool QCPDataRange::operator!= ( const QCPDataRange & other ) const

inline

bool QCPDataRange::operator!= ( const QCPDataRange & other ) const

inline

bool QCPDataRange::operator!= ( const QCPDataRange & other ) const

inline

bool QCPDataRange::operator== ( const QCPDataRange & other ) const

inline

bool QCPDataRange::operator== ( const QCPDataRange & other ) const

inline

bool QCPDataRange::operator== ( const QCPDataRange & other ) const

inline

bool QCPDataRange::operator== ( const QCPDataRange & other ) const

inline

bool QCPDataRange::operator== ( const QCPDataRange & other ) const

inline

void QCPDataRange::setBegin ( int begin )

inline

void QCPDataRange::setBegin ( int begin )

inline

void QCPDataRange::setBegin ( int begin )

inline

Sets the begin of this data range. The begin index points to the first data point that is part of the data range.

No checks or corrections are made to ensure the resulting range is valid (isValid).

See Also: setEnd

void QCPDataRange::setBegin ( int begin )

inline

void QCPDataRange::setBegin ( int begin )

inline