# iterLogspace > Create an iterator which returns evenly spaced numbers over a specified interval.
## Usage ```javascript var iterLogspace = require( '@stdlib/iter/logspace' ); ``` #### iterLogspace( start, stop\[, N]\[, options] ) Returns an iterator which returns evenly spaced numbers on a log scale. ```javascript var it = iterLogspace( 0, 10 ); // returns var v = it.next().value; // returns 1 v = it.next().value; // returns ~1.26 v = it.next().value; // returns ~1.59 // ... ``` The returned iterator protocol-compliant object has the following properties: - **next**: function which returns an iterator protocol-compliant object containing the next iterated value (if one exists) assigned to a `value` property and a `done` property having a `boolean` value indicating whether the iterator is finished. - **return**: function which closes an iterator and returns a single (optional) argument in an iterator protocol-compliant object. The function accepts the following `options`: - **base**: base of the log space. Default: `10`. By default, the iterator returns `100` values. To return an alternative number of values, provide an `N` argument. ```javascript var it = iterLogspace( 0, 2, 3 ); // returns var v = it.next().value; // returns 1 v = it.next().value; // returns 10 v = it.next().value; // returns 100 var bool = it.next().done; // returns true ``` To specify an alternative log base, provide a `base` option. ```javascript var opts = { 'base': 2 }; var it = iterLogspace( 0, 10, 11, opts ); // returns var v = it.next().value; // returns 1 v = it.next().value; // returns 2 v = it.next().value; // returns 4 // ... ```
## Notes - The returned iterator is guaranteed to include the values `base^start` and `base^stop`. Beware, however, that exponents between the `start` and `stop` are subject to floating-point rounding errors. - If an environment supports `Symbol.iterator`, the returned iterator is iterable.
## Examples ```javascript var iterLogspace = require( '@stdlib/iter/logspace' ); // Create a base-2 iterator: var opts = { 'base': 2 }; var it = iterLogspace( 0, 16, 17, opts ); // Perform manual iteration... var v; while ( true ) { v = it.next(); if ( v.done ) { break; } console.log( v.value ); } ```
* * * ## See Also - [`@stdlib/array/from-iterator`][@stdlib/array/from-iterator]: create (or fill) an array from an iterator. - [`@stdlib/iter/datespace`][@stdlib/iter/datespace]: create an iterator which returns evenly spaced dates over a specified interval. - [`@stdlib/iter/incrspace`][@stdlib/iter/incrspace]: create an iterator which returns evenly spaced numbers according to a specified increment. - [`@stdlib/iter/linspace`][@stdlib/iter/linspace]: create an iterator which returns evenly spaced numbers over a specified interval. - [`@stdlib/iter/step`][@stdlib/iter/step]: create an iterator which returns a sequence of numbers according to a specified increment.
[@stdlib/array/from-iterator]: https://www.npmjs.com/package/@stdlib/array-from-iterator [@stdlib/iter/datespace]: https://github.com/stdlib-js/iter/tree/main/datespace [@stdlib/iter/incrspace]: https://github.com/stdlib-js/iter/tree/main/incrspace [@stdlib/iter/linspace]: https://github.com/stdlib-js/iter/tree/main/linspace [@stdlib/iter/step]: https://github.com/stdlib-js/iter/tree/main/step