encloses method
Returns true
if other
's bounds do not extend outside this bounds.
It is not possible for an Interval to enclose a Min or Max. Neither is it possible for a Min
to enclose a
Max
and vice versa.
A discrete range is not considered to be enclosed by another under certain circumstances, i.e. [4..5]
does not
enclose (3..6)
.
A Range that encloses another Range
always intersects.
This method is reflexive, anti-symmetric and transitive.
Examples
final a = Interval.closed(1, 4);
final b = Interval.closedOpen(2, 3);
a.encloses(b); // true, [1..4] encloses [2..3]
final a = Interval.open(1, 4);
final b = Interval.open(1, 4);
a.encloses(b); // true, (1..4) encloses (1..4)
final a = Interval.open(1, 4);
final b = Interval.closedOpen(2, 2);
a.encloses(b); // true, (1..4) encloses [2..2)
final a = Interval.openClosed(3, 6);
final b = Interval.openClosed(2, 8);
a.encloses(b); // false, (3..6] does not enclose (2..8]
final a = Interval.openClosed(3, 6);
final b = Interval.closed(3, 6);
a.encloses(b); // false, (3..6] does not enclose [3..6]
final a = Interval.closed(4, 5);
final b = Interval.open(3, 6);
a.encloses(b); // false, [4..5] does not enclose (3..6), discrete range
final a = Interval.openClosed(3, 6);
final b = Interval.closedOpen(1, 1);
a.encloses(b); // false, (3..6] does not enclose (1..1]
Implementation
@override
bool encloses(Range<T> other) => true;