# NAME

Math::NumSeq::Base::IterateIth -- iterate by calling ith() successively

# SYNOPSIS

```
package MyNumSeqSubclass;
use Math::NumSeq;
use Math::NumSeq::Base::IterateIth;
@ISA = ('Math::NumSeq::Base::IterateIth',
'Math::NumSeq');
sub ith {
my ($self, $i) = @_;
return something($i);
}
```

# DESCRIPTION

This is a multi-inheritance mix-in providing the following methods

```
rewind()
next()
seek_to_i()
```

They iterate simply by calling `ith()`

to get each successive value, starting from `i_start()`

.

This is a handy way to implement the iterating methods for a `NumSeq`

if there's nothing special that `next()`

can do beyond a full `ith()`

calculation.

If `ith()`

returns `undef`

then that's taken to be the end of the sequence and `next()`

returns no values.

# SEE ALSO

# HOME PAGE

http://user42.tuxfamily.org/math-numseq/index.html

# LICENSE

Copyright 2011, 2012, 2013, 2014 Kevin Ryde

Math-NumSeq is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

Math-NumSeq is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Math-NumSeq. If not, see <http://www.gnu.org/licenses/>.