Sequences

Math iterators for generating sequences.

Usage

var ns = require( '@stdlib/math/iter/sequences' );

ns

Namespace containing math iterators for generating sequences.

var iterators = ns;
// returns {...}

The namespace contains the following functions for creating iterator protocol-compliant iterators:

iterCompositesSeq( [options] ): create an iterator which generates a sequence of composite numbers.
iterContinuedFractionSeq( x, [options] ): create an iterator which generates a list of all continued fraction terms which can be obtained given the precision of a provided number.
iterCubesSeq( [options] ): create an iterator which generates a sequence of cubes.
iterEvenIntegersSeq( [options] ): create an iterator which generates an interleaved sequence of even integers.
iterFactorialsSeq( [options] ): create an iterator which generates a sequence of factorials.
iterFibonacciSeq( [options] ): create an iterator which generates a Fibonacci sequence.
iterFifthPowersSeq( [options] ): create an iterator which generates a sequence of fifth powers.
iterFourthPowersSeq( [options] ): create an iterator which generates a sequence of fourth powers.
iterIntegersSeq( [options] ): create an iterator which generates an interleaved integer sequence.
iterLucasSeq( [options] ): create an iterator which generates a Lucas sequence.
iterNegaFibonacciSeq( [options] ): create an iterator which generates a negaFibonacci sequence.
iterNegaLucasSeq( [options] ): create an iterator which generates a negaLucas sequence.
iterNegativeEvenIntegersSeq( [options] ): create an iterator which generates a sequence of negative even integers.
iterNegativeIntegersSeq( [options] ): create an iterator which generates a negative integer sequence.
iterNegativeOddIntegersSeq( [options] ): create an iterator which generates a sequence of negative odd integers.
iterNonFibonacciSeq( [options] ): create an iterator which generates a non-Fibonacci integer sequence.
iterNonNegativeEvenIntegersSeq( [options] ): create an iterator which generates a sequence of nonnegative even integers.
iterNonNegativeIntegersSeq( [options] ): create an iterator which generates a nonnegative integer sequence.
iterNonPositiveEvenIntegersSeq( [options] ): create an iterator which generates a sequence of nonpositive even integers.
iterNonPositiveIntegersSeq( [options] ): create an iterator which generates a nonpositive integer sequence.
iterNonSquaresSeq( [options] ): create an iterator which generates a sequence of nonsquares.
iterOddIntegersSeq( [options] ): create an iterator which generates an interleaved sequence of odd integers.
iterPositiveEvenIntegersSeq( [options] ): create an iterator which generates a sequence of positive even integers.
iterPositiveIntegersSeq( [options] ): create an iterator which generates a positive integer sequence.
iterPositiveOddIntegersSeq( [options] ): create an iterator which generates a sequence of positive odd integers.
iterPrimesSeq( [options] ): create an iterator which generates a sequence of prime numbers.
iterSquaredTriangularSeq( [options] ): create an iterator which generates a sequence of squared triangular numbers.
iterSquaresSeq( [options] ): create an iterator which generates a sequence of squares.
iterTriangularSeq( [options] ): create an iterator which generates a sequence of triangular numbers.

Examples

var ns = require( '@stdlib/math/iter/sequences' );

// Create iterators for generating square and cube numbers:
var squares = ns.iterSquaresSeq();
var cubes = ns.iterCubesSeq();

// Iterate over both sequences and log the first five pairs:
var square;
var cube;
var i;
for ( i = 0; i < 5; i++ ) {
    square = squares.next().value;
    cube = cubes.next().value;
    console.log( 'Square: %d, Cube: %d', square, cube );
}

// Calculate the sum of the first ten Fibonacci numbers:
var fibonacci = ns.iterFibonacciSeq({
    'iter': 10
});
var sum = 0;
var v = fibonacci.next();
while ( v.done === false ) {
    sum += v.value;
    v = fibonacci.next();
}
console.log( 'Sum of first ten Fibonacci numbers: %d', sum );

// Generate prime numbers:
var primes = ns.iterPrimesSeq({
    'iter': 10
});

console.log( 'First ten prime numbers:' );
v = primes.next();
while ( v.done === false ) {
    console.log( v.value );
    v = primes.next();
}