factory_instance =>$obj
# defines the object that implements the $obj->factory($start,$end,$data).
# new ranges are constructed from the factory interfcae. If a factory interface
# is not created an instance of Data::Range::Compare::Stream is assumed.

$compare->add_consolidator($iterator_a);

An $iterator object must implement one of the following iterator classes
Data::Range::Compare::Stream::Iterator::Consolidate
Data::Range::Compare::Stream::Iterator::Compare::Asc
my $boolean=$iterator_a->has_next
Boolean value indicating if there are any more ranges
my $result=$iterator_a->get_next;
$result must implement one of the following result objects:
Data::Range::Compare::Stream::Iterator::Consolidate::Result
Data::Range::Compare::Stream::Iterator::Compare::Result

while($compare->has_next) { do something }

Must be implemented See: Data::Range::Compare::Stream::Iterator::Compare::Asc

my $result=$compare->get_next;

Must be implemented See: Data::Range::Compare::Stream::Iterator::Compare::Asc