mathjs/docs/reference/functions/sech.md

Math.js is an extensive math library for JavaScript and Node.js. It features a flexible expression parser and offers an integrated solution to work with numbers, big numbers, complex numbers, units, and matrices.

<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->

# Function sech

Calculate the hyperbolic secant of a value,
defined as `sech(x) = 1 / cosh(x)`.

For matrices, the function is evaluated element wise.


## Syntax

```js
math.sech(x)
```

### Parameters

Parameter | Type | Description
--------- | ---- | -----------
`x` | number &#124; Complex &#124; Unit &#124; Array &#124; Matrix | Function input

### Returns

Type | Description
---- | -----------
number &#124; Complex &#124; Array &#124; Matrix | Hyperbolic secant of x


## Examples

```js
// sech(x) = 1/ cosh(x)
math.sech(0.5);       // returns 0.886818883970074
1 / math.cosh(0.5);   // returns 0.886818883970074
```


## See also

[cosh](cosh.md),
[csch](csch.md),
[coth](coth.md)