UNPKG

mathjs/docs/reference/functions/acos.md

Version:

850 BMarkdownView Raw

1<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
2
3# Function acos
4
5Calculate the inverse cosine of a value.
6
7For matrices, the function is evaluated element wise.
8
9
10## Syntax
11
12```js
13math.acos(x)
14```
15
16### Parameters
17
18Parameter | Type | Description
19--------- | ---- | -----------
20`x` | number &#124; BigNumber &#124; Complex &#124; Array &#124; Matrix | Function input
21
22### Returns
23
24Type | Description
25---- | -----------
26number &#124; BigNumber &#124; Complex &#124; Array &#124; Matrix | The arc cosine of x
27
28
29## Examples
30
31```js
32math.acos(0.5)           // returns number 1.0471975511965979
33math.acos(math.cos(1.5)) // returns number 1.5
34
35math.acos(2)             // returns Complex 0 + 1.3169578969248166 i
36```
37
38
39## See also
40
41[cos](cos.md),
42[atan](atan.md),
43[asin](asin.md)

1	`<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->`
2
3	`# Function acos`
4
5	`Calculate the inverse cosine of a value.`
6
7	`For matrices, the function is evaluated element wise.`
8
9
10	`## Syntax`
11
12	```js
13	`math.acos(x)`
14	```
15
16	`### Parameters`
17
18	`Parameter \| Type \| Description`
19	`--------- \| ---- \| -----------`
20	`x` \| number \| BigNumber \| Complex \| Array \| Matrix \| Function input
21
22	`### Returns`
23
24	`Type \| Description`
25	`---- \| -----------`
26	`number \| BigNumber \| Complex \| Array \| Matrix \| The arc cosine of x`
27
28
29	`## Examples`
30
31	```js
32	`math.acos(0.5) // returns number 1.0471975511965979`
33	`math.acos(math.cos(1.5)) // returns number 1.5`
34
35	`math.acos(2) // returns Complex 0 + 1.3169578969248166 i`
36	```
37
38
39	`## See also`
40
41	`[cos](cos.md),`
42	`[atan](atan.md),`
43	`[asin](asin.md)`