> For the complete documentation index, see [llms.txt](https://docs.settlers-united.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.settlers-united.com/s4-lua-api-de/su-library-functions/su.math/su.math.acosh.md).

# SU.Math.acosh

## SU.Math.acosh(value)

Gibt den Areakosinus Hyperbolicus (Umkehrfunktion von `cosh` [SU.Math.cosh](/s4-lua-api-de/su-library-functions/su.math/su.math.cosh.md), entspricht `cosh`<sup>`-1`</sup>) zurück.

{% hint style="info" %}
Winkelfunktionen arbeiten mit **Gleitkomma**zahlen, daher sollte das **End**resultat meist **gerundet werden**! **Zwischen**resultate können und sollen meist **so bleiben** wie sie sind. **Beispiel:**

```lua
local degrees = SU.Math.deg(3.14159)    -- liefert 179.9999...
local roundedDegrees = SU.Math.round(degrees)    -- liefert 180
```

{% endhint %}

#### Parameter

* `value`: `number` – Gleitkommazahl im Intervall \[1, unendlich)

#### Rückgabewert

* `number` – Ergebnis im Intervall \[0, unendlich)
* `nan` (not a number, [SU.Math.isNan](/s4-lua-api-de/su-library-functions/su.math/su.math.isnan.md)): Fehler bei Eingaben kleiner als 1

#### Beispiel

```lua
local acoshValue = SU.Math.acosh(2.5)    -- liefert ca. 1.567
```