use v5.14;
use warnings;

=head1 NAME

Attean::ListIterator - Iterator implementation backed by a list/array of values

=head1 VERSION

This document describes Attean::ListIterator version 0.030


  use v5.14;
  use Attean;
  my @values = map { Attean::Literal->new($_) } (1,2,3);
  my $iter = Attean::ListIterator->new(
    values => \@values,
    item_type => 'Attean::API::Term',
  say $iter->next->value; # 1
  say $iter->next->value; # 2
  say $iter->next->value; # 3


The Attean::ListIterator class represents a typed iterator.
It conforms to the L<Attean::API::RepeatableIterator|Attean::API::Iterator> role.

The Attean::ListIterator constructor requires two named arguments:

=over 4

=item values

An array reference containing the items to iterate over.

=item item_type

A string representing the type of the items that will be returned from the


=head1 METHODS

=over 4


package Attean::ListIterator 0.030 {
	use Moo;
	use Scalar::Util qw(blessed);
	use Type::Tiny::Role;
	use Types::Standard qw(ArrayRef Int);
	use namespace::clean;
	has values => (is => 'ro', isa => ArrayRef, required => 1);
	has current => (is => 'rw', isa => Int, init_arg => undef, default => 0);
	sub BUILD {
		my $self	 = shift;
		my $role	= $self->item_type;
		foreach my $item (@{ $self->values }) {
			if (Role::Tiny->is_role($role)) {
				die "ListIterator item <$item> is not a $role" unless (blessed($item) and $item->does($role));

=item C<< reset >>

Resets the iterator's internal state so that iteration begins again at the
beginning of the values array.


	sub reset {
		my $self	= shift;
=item C<< next >>

Returns the iterator's next item, or undef upon reaching the end of iteration.


	sub next {
		my $self	= shift;
		my $list	= $self->values;
		my $index	= $self->current;
		my $item	= $list->[$index];
		return unless defined($item);
		return $item;

=item C<< size >>

Returns the number of elements still remaining in the iterator until it is
fully consumed or until C<< reset >> is called.


	sub size {
		my $self	= shift;
		return scalar(@{ $self->values }) - $self->current;
	with 'Attean::API::RepeatableIterator';




=head1 BUGS

Please report any bugs or feature requests to through the GitHub web interface
at L<>.

=head1 SEE ALSO

=head1 AUTHOR

Gregory Todd Williams  C<< <> >>


Copyright (c) 2014--2020 Gregory Todd Williams.
This program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.