<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">package TAP::Parser::Iterator::Array;

use strict;
use warnings;

use base 'TAP::Parser::Iterator';

=head1 NAME

TAP::Parser::Iterator::Array - Iterator for array-based TAP sources

=head1 VERSION

Version 3.38

=cut

our $VERSION = '3.38';

=head1 SYNOPSIS

  use TAP::Parser::Iterator::Array;
  my @data = ('foo', 'bar', baz');
  my $it   = TAP::Parser::Iterator::Array-&gt;new(\@data);
  my $line = $it-&gt;next;

=head1 DESCRIPTION

This is a simple iterator wrapper for arrays of scalar content, used by
L&lt;TAP::Parser&gt;.  Unless you're writing a plugin or subclassing, you probably
won't need to use this module directly.

=head1 METHODS

=head2 Class Methods

=head3 C&lt;new&gt;

Create an iterator.  Takes one argument: an C&lt;$array_ref&gt;

=head2 Instance Methods

=head3 C&lt;next&gt;

Iterate through it, of course.

=head3 C&lt;next_raw&gt;

Iterate raw input without applying any fixes for quirky input syntax.

=head3 C&lt;wait&gt;

Get the wait status for this iterator. For an array iterator this will always
be zero.

=head3 C&lt;exit&gt;

Get the exit status for this iterator. For an array iterator this will always
be zero.

=cut

# new() implementation supplied by TAP::Object

sub _initialize {
    my ( $self, $thing ) = @_;
    chomp @$thing;
    $self-&gt;{idx}   = 0;
    $self-&gt;{array} = $thing;
    $self-&gt;{exit}  = undef;
    return $self;
}

sub wait { shift-&gt;exit }

sub exit {
    my $self = shift;
    return 0 if $self-&gt;{idx} &gt;= @{ $self-&gt;{array} };
    return;
}

sub next_raw {
    my $self = shift;
    return $self-&gt;{array}-&gt;[ $self-&gt;{idx}++ ];
}

1;

=head1 ATTRIBUTION

Originally ripped off from L&lt;Test::Harness&gt;.

=head1 SEE ALSO

L&lt;TAP::Object&gt;,
L&lt;TAP::Parser&gt;,
L&lt;TAP::Parser::Iterator&gt;,

=cut

</pre></body></html>