Skip to content

Commit cd61dde

Browse files
committed
Document overload
1 parent 2c9548a commit cd61dde

1 file changed

Lines changed: 32 additions & 0 deletions

File tree

  • lib/node_modules/@stdlib/iter/logspace/docs/types

lib/node_modules/@stdlib/iter/logspace/docs/types/index.d.ts

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,38 @@ interface Options {
6666
* // ...
6767
*/
6868
declare function iterLogspace( start: number, stop: number, N: number, options?: Options ): Iterator; // tslint:disable-line: max-length
69+
70+
/**
71+
* Returns an iterator which returns evenly spaced numbers on a log scale.
72+
*
73+
* ## Notes
74+
*
75+
* - If an environment supports `Symbol.iterator`, the returned iterator is iterable.
76+
*
77+
* @param start - exponent of starting value (inclusive)
78+
* @param stop - exponent of stopping value (inclusive)
79+
* @param options - function options
80+
* @param options.base - base of log space (default: 10)
81+
* @throws `base` option must be a positive number
82+
* @returns iterator
83+
*
84+
* @example
85+
* var opts = {
86+
* 'base': 2
87+
* };
88+
* var iter = iterLogspace( 0, 99, opts );
89+
*
90+
* var v = iter.next().value;
91+
* // returns 1
92+
*
93+
* v = iter.next().value;
94+
* // returns 2
95+
*
96+
* v = iter.next().value;
97+
* // returns 4
98+
*
99+
* // ...
100+
*/
69101
declare function iterLogspace( start: number, stop: number, options?: Options ): Iterator; // tslint:disable-line: max-length
70102

71103

0 commit comments

Comments
 (0)