# log1mexp
> Evaluates the [natural logarithm][@stdlib/math/base/special/ln] of `1-exp(-|x|)`.
## Usage
```javascript
var log1mexp = require( '@stdlib/math/base/special/log1mexp' );
```
#### log1mexp( x )
Evaluates the [natural logarithm][@stdlib/math/base/special/ln] of `1-exp(-|x|)`.
```javascript
var y = log1mexp( 0.0 );
// returns -Infinity
y = log1mexp( 5.0 );
// returns ~-0.00676
y = log1mexp( 10.0 );
// returns ~-0.00005
y = log1mexp( -10.0 );
// returns ~-0.00005
y = log1mexp( NaN );
// returns NaN
```
## Examples
```javascript
var incrspace = require( '@stdlib/array/incrspace' );
var log1mexp = require( '@stdlib/math/base/special/log1mexp' );
var x = incrspace( -10.0, 10.0, 0.01 );
var v;
var i;
for ( i = 0; i < x.length; i++ ) {
v = log1mexp( x[ i ] );
console.log( 'x: %d, f(x): %d', x[ i ], v );
}
```
[@stdlib/math/base/special/ln]: https://www.npmjs.com/package/@stdlib/math/tree/main/base/special/ln