SpanOrVoid

The span's length. For a void span, this is zero, otherwise it is stop - start.

Clips a position to this span's boundary. Note that the span's stop position is included. Thus the result is greater than or equal the start, and less than or equal (!) the stop.

For the special cases of Span.All and Span.Void, this method returns the argument unchanged.

Compares the span's start to a given position

Compares the span's stop to a given position

Checks if another span lies within the span. The result is false if either of the two spans is void.

Checks if a position lies within the span. Note that this returns false if this.stop == pos.

Checks if the span is empty. A span is empty if it is a Span with start == stop or if it is void.

Checks if the span is non empty. This is exactly the opposite value of isEmpty.

Checks if a two spans overlap each other. Two spans overlap if the overlapping area is greater than or equal to 1. This implies that if either span is empty, the result will be false.

This method is commutative (a overlaps b == b overlaps a).

Checks if a two spans overlap or touch each other. Two spans touch each other if they either overlap or they share a common point with each other (this span's start or stop is that span's start or stop).

This method is commutative (a touches b == b touches a).

Constructs a single span which contains both this and that span. If the two spans are disjoint, the result will be a span with start = min(this.start, that.start) and stop = max(this.stop, that.stop). If either span is void, the other span is returned. If either span is Span.All, Span.All will be returned.

This method is commutative (a union b == b union a).