Информация Math Functions | Перевод на русский

Ещё в не таком далёком 2020 году я перевёл математические функции и парочку других на русский язык. Предлагал свой перевод для сайта ahk-wiki.ru, но что-то пошло не так. Решать вам - это забил админ сайта на перевод или сам перевод херовый.
Original: https://www.autohotkey.com/docs/commands/Math.htm​

---

Спойлер: General Math

Abs: Returns the absolute value of a number.
Abs: Возвращает всегда положительное число.
Ceil: Returns a number rounded up to the nearest integer.
Ceil: Возвращает число, округлённое к ближайшему большему целому числу.
Exp: Returns e raised to the Nth power.
Exp: Возвращает число e(2.71...) в N степени.
Floor: Returns a number rounded down to the nearest integer.
Floor: Возвращает целое число, округлённое в меньшую сторону.
Log: Returns the logarithm (base 10) of a number.
Log: Возвращает логарифм числа по основанию 10.
Ln: Returns the natural logarithm (base e) of a number.
Ln: Возвращает натуральный логарифм числа по основанию e(2.71...).
Max [v1.1.27+]: Returns the highest value of one or more numbers.
Max [v1.1.27+]: Возвращаем наибольшее число из списка указанных чисел.
Min [v1.1.27+]: Returns the lowest value of one or more numbers.
Min [v1.1.27+]: Возвращаем наименьшее число из списка указанных чисел.
Mod: Returns the remainder of a division.
Mod: Возвращает остаток от деления числа.
Round: Returns a number rounded to N decimal places.
Round: Возвращает число, округлённое до N. Может округлить ненужный остаток, тем самым убрав запятую, либо показать весь необходимый остаток после запятой.
Sqrt: Returns the square root of a number.
Sqrt: Возвращает квадратный корень числа.

Спойлер: Trigonometry

Sin: Returns the trigonometric sine of a number.
Sin: Возвращает синус числа.
Cos: Returns the trigonometric cosine of a number.
Cos: Возвращает косинус числа.
Tan: Returns the trigonometric tangent of a number.
Tan: Возвращает тангенс числа.
ASin: Returns the arcsine (the number whose sine is the specified number) in radians.
ASin: Возвращает арксинус (число(x), при котором синус y = x) в радианах.
ACos: Returns the arccosine (the number whose cosine is the specified number) in radians.
ACos: Возвращает арккосинус (число(x), при котором косинус y = x) в радианах.
ATan: Returns the arctangent (the number whose tangent is the specified number) in radians.
ATan: Возвращает арктангенс (число(x), при котором тангенс y = x) в радианах.

Abs()​

Returns the absolute value of Number.
Возвращает абсолютное значение числа. Всегда положительное число, даже если указанный параметр отрицательный.
Возвращаемое значение меняет свой вид в зависимости от настройки Setformat. Может вернуть как целое число, так и десятичное.
MsgBox, % Abs(-100.50) ; Возвращает 100.50

Ceil()​

Returns Number rounded up to the nearest integer (without any .00 suffix).
Возвращает число, округлённое к ближайшему большему целому числу. Без десятичного остатка.
MsgBox, % Ceil(1.2) ; Возвращает 2
MsgBox, % Ceil(-1.2) ; Возвращает -1

Exp()​

Returns e (which is approximately 2.71828182845905) raised to the Nth power.
Возвращает число e(2.71...), возведённое в степень N.
N may be negative and may contain a decimal point. To raise numbers other than e to a power, use the ** operator.
Степень N может быть отрицательная и может содержать десятичную точку. Чтобы возвести числа помимо e в степень, используйте ** оператор.
MsgBox, % Exp(1.2) ; Возвращает 3.320117
MsgBox, % 2**5 ; Возвращает 32, т.к. это 2 в степени 5

Floor()​

Returns Number rounded down to the nearest integer (without any .00 suffix).
Возвращает число, округлённое к ближайшему меньшему целому числу. Без десятичного остатка.
MsgBox, % Floor(1.2) ; Возвращает 1
MsgBox, % Floor(-1.2) ; Возвращает -2

Log()​

Returns the logarithm (base 10) of Number.
Возвращает число, основа логарифма которого равна 10.
The result is formatted as floating point. If Number is negative, an empty string is returned.
В результате мы получаем число с остатком после запятой. Если значение отрицательное, возвращается пустая строка.
MsgBox, % Log(1.2) ; Возвращает 0.079181

Ln()​

Returns the natural logarithm (base e) of Number.
Возвращает число, основа натурального логарифма которого равна числу е(2.71...).
The result is formatted as floating point. If Number is negative, an empty string is returned.
В результате, мы получаем число с остатком после запятой. Если значение отрицательное, возвращается пустая строка.
MsgBox, % Ln(1.2) ; Возвращает 0.182322

Max()​

Returns the highest value of one or more numbers.
Возвращает наибольшее число из списка приведенных в функцию.
If one of the input values is non-numeric, an empty string is returned.
Если одно из вводимых значений не является цифрой, возвращается пустая строка.
MsgBox, % Max(2.11, -2, 0) ; Возвращает 2.11
You can also specify a variadic parameter to compare multiple values within an array. For example:
Вы можете указать в значение функции переменную для обработки значений массива. Например:
array := [1, 5, 3, 4]
MsgBox, % Max(array*) ; Возвращает 5

Min()​

Returns the lowest value of one or more numbers.
Возвращает наименьшее число из списка приведенных в функцию.
If one of the input values is non-numeric, an empty string is returned.
Если одно из вводимых значений не является цифрой, возвращается пустая строка.
MsgBox, % Min(2.11, -2, 0) ; Возвращает -2
You can also specify a variadic parameter to compare multiple values within an array. For example:
Вы можете указать в значение функции переменную для обработки значений массива. Например:
array := [7, 2, 1, 4]
MsgBox, % Min(array*) ; Возвращает 1

Mod()​

Modulo. Returns the remainder when Dividend is divided by Divisor.
Возвращает остаток от деления числа на его делитель.
The sign of the result is always the same as the sign of the first parameter. If either input is a floating point number, the result is also a floating point number. If the second parameter is zero, the function yields a blank result (empty string).
Знак числа остаётся неизменным числу первого параметра. Если вводимое число является числом с остатком после запятой, возвращаемое число так же будет иметь остаток после запятой. Если второй параметр равен 0, возвращается пустой результат.
MsgBox, % Mod(7.5, 2) ; Возвращает 1.5 (2 x 3 + 1.5)

Round()​

Returns Number rounded to N decimal places.
Возвращает округлённое число до N десятичных знаков.
If N is omitted or 0, Number is rounded to the nearest integer:
Если указан лишь 1 параметр функции(наше число) или 0 во втором параметре(знак, до которого округляем), число округляется до ближайшего целого.
MsgBox, % Round(3.14) ; Возвращает 3
If N is positive number, Number is rounded to N decimal places:
Если второй параметр(N) > 0, то число округляется до N десятичного знака.
MsgBox, % Round(3.14, 1) ; Возвращает 3.1
If N is negative, Number is rounded by N digits to the left of the decimal point:
Если второй параметр(N) отрицательный, то число округляется к ближайшему > или < числу до N от левой стороны.
MsgBox, % Round(345, -1) ; Возвращается 350, т.к. округление произошло от числа **5 в > сторону.
MsgBox, % Round(345, -2) ; Возвращается 300, т.к. округление произошло от числа *45 в < сторону.
MsgBox, % Round(574, -1) ; Возвращается 570, т.к. округление произошло от числа **4 в < сторону.
MsgBox, % Round(8615, -2) ; Возвращается 8600, т.к. округление произошло от числа **15 в < сторону.
Unlike Transform Round, the result has no .000 suffix whenever N is omitted or less than 1. [v1.0.44.01+]: A value of N greater than zero displays exactly N decimal places rather than obeying SetFormat. To avoid this, perform another math operation on Round()'s return value; for example: Round(3.333, 1)+0.
В отличии от Transform Round, результат не имеет остатка, если N опущено или < 1. [v1.0.44.01+]: результат при N > 0 не подчиняется изменениям со стороны SetFormat. Чтобы нивелировать это, выполните ещё одну математическую операцию Round() с результатом.

Sqrt()​

Returns the square root of Number.
Возвращает квадратный корень числа.
The result is formatted as floating point. If Number is negative, the function yields a blank result (empty string).
Результат может быть с остатком после запятой. Если число отрицательное, функция вернёт пустой результат.
MsgBox, % Sqrt(16) ; Возвращает 4
MsgBox, % Sqrt(15) ; Возвращает 3.872983

Trigonometry​

---

Sin()​

Returns the trigonometric sine of Number.
Возвращает синус числа.
Number must be expressed in radians.
Число должно быть выражено в радианах.
MsgBox, % Sin(1.2) ; Возвращает 0.932039

Cos()​

Returns the trigonometric cosine of Number.
Возвращает косинус числа.
Number must be expressed in radians.
Число должно быть выражено в радианах.
MsgBox, % Cos(1.2) ; Возвращает 0.362358

Tan()​

Returns the trigonometric tangent of Number.
Возвращает тангенс числа.
Number must be expressed in radians.
Число должно быть выражено в радианах.
MsgBox, % Tan(1.2) ; Возвращает 2.572152

ASin()​

Returns the arcsine (the number whose sine is Number) in radians.
Возвращает арксинус (число(x), при котором синус y = x) в радианах.
If Number is less than -1 or greater than 1, the function yields a blank result (empty string).
Если число меньше -1 или больше 1, функция вернёт пустой результат.
MsgBox, % ASin(0.2) ; Возвращает 0.201358

ACos()​

Returns the arccosine (the number whose cosine is Number) in radians.
Возвращает арккосинус (число(x), при котором косинус y = x) в радианах.
If Number is less than -1 or greater than 1, the function yields a blank result (empty string).
Если число меньше -1 или больше 1, функция вернёт пустой результат.
MsgBox, % ACos(0.2) ; Возвращает 1.369438

ATan()​

Returns the arctangent (the number whose tangent is Number) in radians.
Возвращает арктангенс (число(x), при котором тангенс y = x) в радианах.
MsgBox, % ATan(1.2) ; Возвращает 0.876058

Возможные ошибки:​

Invalid operations such as divide by zero generally yield a blank result (empty string).
"Ошибочные" операции, такие, как деление на ноль, возвращают пустой результат.

Abs, Max, Min and Mod return an empty string if any of their incoming parameters are non-numeric. Most math functions do not perform strict type-checking, so may treat non-numeric values as zero or another number. For example, Round("1.0foo") produces 1. However, this is expected to change in AutoHotkey v2.

Abs, Max, Min и Mod возвращают пустой результат, если входящий параметр не является числом. Большинство математических функций не имеют строгой проверки на числовой тип входящего параметра. Если задать в параметр Round("1.0foo"), функция вернёт 1. Данная особенность будет изменена в AutoHotkey v2.

upd1: Буду править некоторые моменты, перевод устарел и требует доработки 🤪

 

[Oreshka23]

Abs()​

Возвращает абсолютное значение числа. Всегда положительное число, даже если указанный параметр отрицательный.

Это называется модуль

 

[kin4stat]

Нахуя, а главное нахуя? Почти все функции имеют говорящее название

 

[degrando]

Лишь только он ещё старается что то реализовать на ахк.... Респект....