require ‘mega/infinity‘

Methods
Included Modules
Public Class methods
[]( *args ) [ source ]
new(first, last, exclude_first=false, exclude_last=false ) [ source ]
Public Instance methods
+@() [ source ]

Unary shorthands. These return a new interval exclusive of first, last or both sentinels, repectively.

-@() [ source ]
===(x)

Alias for include?

begin()

Alias for first

closed() [ source ]

Returns a new interval inclusive of of both sentinels.

degenerate?() [ source ]

Returns true if the start and end sentinels are equal and the interval is closed; otherwise false.

direction() [ source ]

Returns the direction of the interval indicated by +1, 0 or -1. 

  (1..5).direction  #=> 1
  (5..1).direction  #=> -1
  (1..1).direction  #=> 0
distance() [ source ]

Returns the length of the interval as the difference between the first and last elements. Returns nil if the sentinal objects do not support distance comparison (distance). TODO: Add n parameter to count segmentations like those produced by each.

This method is also aliased as length size
each(n=1, d=nil) {|| ...} [ source ]

Iterates over the interval, passing each _n_th element to the block. If n is not given then n defaults to 1. Each _n_th step is determined by invoking +++ or +\-+ n, depending on the direction of the interval. If n is negative the iteration is preformed in reverse form end sentinal to front sentinal. A second parameter, d, can be given in which case the applied step is calculated as a fraction of the interval’s length times n / d. This allows iteration over the whole interval in equal sized segments. 

  1..5.each { |e| ... }        #=> 1 2 3 4 5
  1..5.each(2) { |e| ... }     #=> 1 3 5
  1..5.each(1,2) { |e| ... }   #=> 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
This method is also aliased as step
end()

Alias for last

eql?(other) [ source ]

Compares two intervals to see if they are equal

exclude_begin?()

Alias for exclude_first?

exclude_end?()

Alias for exclude_last?

exclude_first?() [ source ]
This method is also aliased as exclude_begin?
exclude_last?() [ source ]
This method is also aliased as exclude_end?
first() [ source ]

Returns the first or last sentinal of the interval.

This method is also aliased as begin
first_closed() [ source ]

Returns a new interval with one of the two sentinels opened or closed

first_opened() [ source ]
half_closed(e=false) [ source ]

Returns a new interval with either the first or the last sentinel exclusive. If the parameter is false, the deafult, then the first sentinel is excluded; if the parameter is true, the last sentinel is excluded.

include?(x) [ source ]

Returns true or false if the element is part of the interval.

This method is also aliased as === member?
last() [ source ]
This method is also aliased as end
last_closed() [ source ]
last_opened() [ source ]
length()

Alias for distance

max() [ source ]

Returns the greater of the first and last sentinals.

member?(x)

Alias for include?

min() [ source ]

Returns the lesser of the first and last sentinals.

null?() [ source ]

Returns true if the start and end sentinels are equal and the interval is open; otherwise false.

opened() [ source ]

Returns a new interval exclusive of both sentinels.

reversed() [ source ]

Returns a new interval with the sentinels reversed. 

  (0..10).reversed  #=> 10..0
sentinels() [ source ]

Returns a two element array of first and last sentinels. 

 (0..10).sentinels   #=> [0,10]
size()

Alias for distance

step(n=1, d=nil)

Alias for each

~() [ source ]