NAME

Data::Range::Compare::Stream::Iterator::Stack - Walk many iterators with one interface

SYNOPSIS

use Data::Range::Compare::Stream;
use Data::Range::Compare::Stream::Iterator::File;
use Data::Range::Compare::Stream::Iterator::Stack;

my $stack=new Data::Range::Compare::Stream::Iterator::Stack;

my $iterator_a=Data::Range::Compare::Stream::Iterator::File->new(
  filename=>'some_file.csv',
);

$stack->stack_push($iterator_a);

my $iterator_b=Data::Range::Compare::Stream::Iterator::File->new(
  filename=>'some_file.csv',
);

$stack->stack_push($iterator_b);

while($stack->has_next) {
  my $next_range=$stack->get_next;
  print $next_range,"\n";
}

DESCRIPTION

Allows seamless iteration through multiple objects that implement: Data::Range::Compare::Stream::Iterator::Base. Data::Range::Compare::Stream::Iterator::Stack extends Data::Range::Compare::Stream::Iterator::Base and can be passed to another instance of itself.

OO Methods

• my $iterator=new Data::Range::Compare::Stream::Iterator::File;

  Instance Constructor, all arguments are optional

  Optional arguments:

  stack=>[]
    # an array ref of objects that implement Data::Range::Compare::Stream::Iterator::Base
  
  parse_line=>undef|code_ref
    # Default: undef, Sets the code ref to be used when parsing a line
    # if not set the default internals will be used
  
  result_to_line=>undef|code_ref
    # Default: undef, Sets the code ref used to convert a result to a line that can be parsed
    # if not set the default internals will be used

• while($iterator->has_next) { ... }

  Returns true when one or more objects on the stack has_next.

• my $result=$iterator->get_next;

  Returns the next $result from the given source file.

• $stack->stack_push($iterator);

  This interface can be used to add an iterator onto the stack. Objects being added to the stack need to implement or extend Data::Range::Compare::Iterator::Base.

SEE ALSO

Data::Range::Compare::Stream::Cookbook

AUTHOR

Michael Shipper

Source-Forge Project

As of version 0.001 the Project has been moved to Source-Forge.net

Data Range Compare https://sourceforge.net/projects/data-range-comp/

COPYRIGHT

Copyright 2011 Michael Shipper. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.