Merge pull request #17704 from sevirov/sevirov-DOCSUP-4523-add_some_of_missed_cmath_functions

DOCSUP-4523: Add some of missed cmath functions
2024-11-26 09:32:01 +00:00 · 2020-12-10 01:45:41 +03:00 · 2020-12-10 01:45:41 +03:00 · 35b549a0d4
commit 35b549a0d4
parent 80d4af9a73 fadf764fef
2 changed files with 604 additions and 0 deletions
--- a/docs/en/sql-reference/functions/math-functions.md
+++ b/docs/en/sql-reference/functions/math-functions.md
@ -111,4 +111,306 @@ Accepts a numeric argument and returns a UInt64 number close to 2 to the power o

 Accepts a numeric argument and returns a UInt64 number close to 10 to the power of x.

+## cosh(x) {#coshx}
+
+[Hyperbolic cosine](https://in.mathworks.com/help/matlab/ref/cosh.html).
+
+**Syntax**
+
+``` sql
+cosh(x)
+```
+
+**Parameters**
+
+-   `x` — The angle, in radians. Values from the interval: `-∞ < x < +∞`. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Returned value**
+
+-   Values from the interval: `1 <= cosh(x) < +∞`.
+
+Type: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Example**
+
+Query:
+
+``` sql
+SELECT cosh(0);
+```
+
+Result:
+
+``` text
+┌─cosh(0)──┐
+│        1 │
+└──────────┘
+```
+
+## acosh(x) {#acoshx}
+
+[Inverse hyperbolic cosine](https://www.mathworks.com/help/matlab/ref/acosh.html).
+
+**Syntax**
+
+``` sql
+acosh(x)
+```
+
+**Parameters**
+
+-   `x` — Hyperbolic cosine of angle. Values from the interval: `1 <= x < +∞`. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Returned value**
+
+-   The angle, in radians. Values from the interval: `0 <= acosh(x) < +∞`.
+
+Type: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Example**
+
+Query:
+
+``` sql
+SELECT acosh(1);
+```
+
+Result:
+
+``` text
+┌─acosh(1)─┐
+│        0 │
+└──────────┘
+```
+
+**See Also**
+
+-   [cosh(x)](../../sql-reference/functions/math-functions.md#coshx)
+
+## sinh(x) {#sinhx}
+
+[Hyperbolic sine](https://www.mathworks.com/help/matlab/ref/sinh.html).
+
+**Syntax**
+
+``` sql
+sinh(x)
+```
+
+**Parameters**
+
+-   `x` — The angle, in radians. Values from the interval: `-∞ < x < +∞`. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Returned value**
+
+-   Values from the interval: `-∞ < sinh(x) < +∞`.
+
+Type: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Example**
+
+Query:
+
+``` sql
+SELECT sinh(0);
+```
+
+Result:
+
+``` text
+┌─sinh(0)──┐
+│        0 │
+└──────────┘
+```
+
+## asinh(x) {#asinhx}
+
+[Inverse hyperbolic sine](https://www.mathworks.com/help/matlab/ref/asinh.html).
+
+**Syntax**
+
+``` sql
+asinh(x)
+```
+
+**Parameters**
+
+-   `x` — Hyperbolic sine of angle. Values from the interval: `-∞ < x < +∞`. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Returned value**
+
+-   The angle, in radians. Values from the interval: `-∞ < asinh(x) < +∞`.
+
+Type: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Example**
+
+Query:
+
+``` sql
+SELECT asinh(0);
+```
+
+Result:
+
+``` text
+┌─asinh(0)─┐
+│        0 │
+└──────────┘
+```
+
+**See Also**
+
+-   [sinh(x)](../../sql-reference/functions/math-functions.md#sinhx)
+
+## atanh(x) {#atanhx}
+
+[Inverse hyperbolic tangent](https://www.mathworks.com/help/matlab/ref/atanh.html).
+
+**Syntax**
+
+``` sql
+atanh(x)
+```
+
+**Parameters**
+
+-   `x` — Hyperbolic tangent of angle. Values from the interval: `–1 < x < 1`. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Returned value**
+
+-   The angle, in radians. Values from the interval: `-∞ < atanh(x) < +∞`.
+
+Type: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Example**
+
+Query:
+
+``` sql
+SELECT atanh(0);
+```
+
+Result:
+
+``` text
+┌─atanh(0)─┐
+│        0 │
+└──────────┘
+```
+
+## atan2(y, x) {#atan2yx}
+
+The [function](https://en.wikipedia.org/wiki/Atan2) calculates the angle in the Euclidean plane, given in radians, between the positive x axis and the ray to the point `(x, y) ≠ (0, 0)`.
+
+**Syntax**
+
+``` sql
+atan2(y, x)
+```
+
+**Parameters**
+
+-   `y` — y-coordinate of the point through which the ray passes. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+-   `x` — x-coordinate of the point through which the ray passes. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Returned value**
+
+-   The angle `θ` such that `−π < θ ≤ π`, in radians.
+
+Type: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Example**
+
+Query:
+
+``` sql
+SELECT atan2(1, 1);
+```
+
+Result:
+
+``` text
+┌────────atan2(1, 1)─┐
+│ 0.7853981633974483 │
+└────────────────────┘
+```
+
+## hypot(x, y) {#hypotxy}
+
+Calculates the length of the hypotenuse of a right-angle triangle. The [function](https://en.wikipedia.org/wiki/Hypot) avoids problems that occur when squaring very large or very small numbers.
+
+**Syntax**
+
+``` sql
+hypot(x, y)
+```
+
+**Parameters**
+
+-   `x` — The first cathetus of a right-angle triangle. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+-   `y` — The second cathetus of a right-angle triangle. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Returned value**
+
+-   The length of the hypotenuse of a right-angle triangle.
+
+Type: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Example**
+
+Query:
+
+``` sql
+SELECT hypot(1, 1);
+```
+
+Result:
+
+``` text
+┌────────hypot(1, 1)─┐
+│ 1.4142135623730951 │
+└────────────────────┘
+```
+
+## log1p(x) {#log1px}
+
+Calculates `log(1+x)`. The [function](https://en.wikipedia.org/wiki/Natural_logarithm#lnp1) `log1p(x)` is more accurate than `log(1+x)` for small values of x.
+
+**Syntax**
+
+``` sql
+log1p(x)
+```
+
+**Parameters**
+
+-   `x` — Values from the interval: `-1 < x < +∞`. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Returned value**
+
+-   Values from the interval: `-∞ < log1p(x) < +∞`.
+
+Type: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Example**
+
+Query:
+
+``` sql
+SELECT log1p(0);
+```
+
+Result:
+
+``` text
+┌─log1p(0)─┐
+│        0 │
+└──────────┘
+```
+
+**See Also**
+
+-   [log(x)](../../sql-reference/functions/math-functions.md#logx-lnx)
+
 [Original article](https://clickhouse.tech/docs/en/query_language/functions/math_functions/) <!--hide-->
--- a/docs/ru/sql-reference/functions/math-functions.md
+++ b/docs/ru/sql-reference/functions/math-functions.md
@ -103,4 +103,306 @@ SELECT erf(3 / sqrt(2))

 Принимает два числовых аргумента x и y. Возвращает число типа Float64, близкое к x в степени y.

+## cosh(x) {#coshx}
+
+[Гиперболический косинус](https://help.scilab.org/docs/5.4.0/ru_RU/cosh.html).
+
+**Синтаксис**
+
+``` sql
+cosh(x)
+```
+
+**Параметры**
+
+-   `x` — угол в радианах. Значения из интервала: `-∞ < x < +∞`. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Возвращаемое значение**
+
+-   Значения из интервала: `1 <= cosh(x) < +∞`.
+
+Тип: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT cosh(0);
+```
+
+Результат:
+
+``` text
+┌─cosh(0)──┐
+│        1 │
+└──────────┘
+```
+
+## acosh(x) {#acoshx}
+
+[Обратный гиперболический косинус](https://help.scilab.org/docs/5.4.0/ru_RU/acosh.html).
+
+**Синтаксис**
+
+``` sql
+acosh(x)
+```
+
+**Параметры**
+
+-   `x` — гиперболический косинус угла. Значения из интервала: `1 <= x < +∞`. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Возвращаемое значение**
+
+-   Угол в радианах. Значения из интервала: `0 <= acosh(x) < +∞`.
+
+Тип: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT acosh(1);
+```
+
+Результат:
+
+``` text
+┌─acosh(1)─┐
+│        0 │
+└──────────┘
+```
+
+**Смотрите также**
+
+-   [cosh(x)](../../sql-reference/functions/math-functions.md#coshx)
+
+## sinh(x) {#sinhx}
+
+[Гиперболический синус](https://help.scilab.org/docs/5.4.0/ru_RU/sinh.html).
+
+**Синтаксис**
+
+``` sql
+sinh(x)
+```
+
+**Параметры**
+
+-   `x` — угол в радианах. Значения из интервала: `-∞ < x < +∞`. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Возвращаемое значение**
+
+-   Значения из интервала: `-∞ < sinh(x) < +∞`.
+
+Тип: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT sinh(0);
+```
+
+Результат:
+
+``` text
+┌─sinh(0)──┐
+│        0 │
+└──────────┘
+```
+
+## asinh(x) {#asinhx}
+
+[Обратный гиперболический синус](https://help.scilab.org/docs/5.4.0/ru_RU/asinh.html).
+
+**Синтаксис**
+
+``` sql
+asinh(x)
+```
+
+**Параметры**
+
+-   `x` — гиперболический синус угла. Значения из интервала: `-∞ < x < +∞`. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Возвращаемое значение**
+
+-   Угол в радианах. Значения из интервала: `-∞ < asinh(x) < +∞`.
+
+Тип: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT asinh(0);
+```
+
+Результат:
+
+``` text
+┌─asinh(0)─┐
+│        0 │
+└──────────┘
+```
+
+**Смотрите также**
+
+-   [sinh(x)](../../sql-reference/functions/math-functions.md#sinhx)
+
+## atanh(x) {#atanhx}
+
+[Обратный гиперболический тангенс](https://help.scilab.org/docs/5.4.0/ru_RU/atanh.html).
+
+**Синтаксис**
+
+``` sql
+atanh(x)
+```
+
+**Параметры**
+
+-   `x` — гиперболический тангенс угла. Значения из интервала: `–1 < x < 1`. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Возвращаемое значение**
+
+-   Угол в радианах. Значения из интервала: `-∞ < atanh(x) < +∞`.
+
+Тип: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT atanh(0);
+```
+
+Результат:
+
+``` text
+┌─atanh(0)─┐
+│        0 │
+└──────────┘
+```
+
+## atan2(y, x) {#atan2yx}
+
+[Функция](https://msoffice-prowork.com/ref/excel/excelfunc/math/atan2/) вычисляет угол в радианах между положительной осью x и линией, проведенной из начала координат в точку `(x, y) ≠ (0, 0)`.
+
+**Синтаксис**
+
+``` sql
+atan2(y, x)
+```
+
+**Параметры**
+
+-   `y` — координата y точки, в которую проведена линия. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+-   `x` — координата х точки, в которую проведена линия. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Возвращаемое значение**
+
+-   Угол `θ` в радианах из интервала: `−π < θ ≤ π`.
+
+Тип: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT atan2(1, 1);
+```
+
+Результат:
+
+``` text
+┌────────atan2(1, 1)─┐
+│ 0.7853981633974483 │
+└────────────────────┘
+```
+
+## hypot(x, y) {#hypotxy}
+
+Вычисляет длину гипотенузы прямоугольного треугольника. При использовании этой [функции](https://php.ru/manual/function.hypot.html) не возникает проблем при возведении в квадрат очень больших или очень малых чисел.
+
+**Синтаксис**
+
+``` sql
+hypot(x, y)
+```
+
+**Параметры**
+
+-   `x` — первый катет прямоугольного треугольника. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+-   `y` — второй катет прямоугольного треугольника. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Возвращаемое значение**
+
+-   Длина гипотенузы прямоугольного треугольника.
+
+Тип: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT hypot(1, 1);
+```
+
+Результат:
+
+``` text
+┌────────hypot(1, 1)─┐
+│ 1.4142135623730951 │
+└────────────────────┘
+```
+
+## log1p(x) {#log1px}
+
+Вычисляет `log(1+x)`. [Функция](https://help.scilab.org/docs/6.0.1/ru_RU/log1p.html) `log1p(x)` является более точной, чем функция `log(1+x)` для малых значений x.
+
+**Синтаксис**
+
+``` sql
+log1p(x)
+```
+
+**Параметры**
+
+-   `x` — значения из интервала: `-1 < x < +∞`. [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Возвращаемое значение**
+
+-   Значения из интервала: `-∞ < log1p(x) < +∞`.
+
+Тип: [Float64](../../sql-reference/data-types/float.md#float32-float64).
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT log1p(0);
+```
+
+Результат:
+
+``` text
+┌─log1p(0)─┐
+│        0 │
+└──────────┘
+```
+
+**Смотрите также**
+
+-   [log(x)](../../sql-reference/functions/math-functions.md#logx)
+
 [Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/functions/math_functions/) <!--hide-->