# iterEmpty
> Create an empty iterator.
## Usage
```javascript
var iterEmpty = require( '@stdlib/iter/empty' );
```
#### iterEmpty()
Returns an "empty" iterator (i.e., an iterator which never returns an iterated value).
```javascript
var it = iterEmpty();
// returns
## Notes
- If an environment supports `Symbol.iterator`, the returned iterator is iterable.
## Examples
```javascript
var iterEmpty = require( '@stdlib/iter/empty' );
// Create an iterator:
var it = iterEmpty();
// Perform manual iteration...
var v;
while ( true ) {
v = it.next();
if ( v.done ) {
console.log( 'done' );
break;
}
// The following should never run...
console.log( v.value );
}
```
* * *
## See Also
- [`@stdlib/iter/constant`][@stdlib/iter/constant]: create an iterator which always returns the same value.
[@stdlib/iter/constant]: https://github.com/stdlib-js/iter/tree/main/constant