48 lines
		
	
	
		
			821 B
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			48 lines
		
	
	
		
			821 B
		
	
	
	
		
			Markdown
		
	
	
	
	
	
<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
 | 
						|
 | 
						|
# Function sec
 | 
						|
 | 
						|
Calculate the secant of a value, defined as `sec(x) = 1/cos(x)`.
 | 
						|
 | 
						|
For matrices, the function is evaluated element wise.
 | 
						|
 | 
						|
 | 
						|
## Syntax
 | 
						|
 | 
						|
```js
 | 
						|
math.sec(x)
 | 
						|
```
 | 
						|
 | 
						|
### Parameters
 | 
						|
 | 
						|
Parameter | Type | Description
 | 
						|
--------- | ---- | -----------
 | 
						|
`x` | number | Complex | Unit | Array | Matrix | Function input
 | 
						|
 | 
						|
### Returns
 | 
						|
 | 
						|
Type | Description
 | 
						|
---- | -----------
 | 
						|
number | Complex | Array | Matrix | Secant of x
 | 
						|
 | 
						|
 | 
						|
### Throws
 | 
						|
 | 
						|
Type | Description
 | 
						|
---- | -----------
 | 
						|
 | 
						|
 | 
						|
## Examples
 | 
						|
 | 
						|
```js
 | 
						|
math.sec(2)      // returns number -2.4029979617223822
 | 
						|
1 / math.cos(2)  // returns number -2.4029979617223822
 | 
						|
```
 | 
						|
 | 
						|
 | 
						|
## See also
 | 
						|
 | 
						|
[cos](cos.md),
 | 
						|
[csc](csc.md),
 | 
						|
[cot](cot.md)
 |