generated from hexlet-basics/exercises-template
-
Notifications
You must be signed in to change notification settings - Fork 3
/
description.ru.yml
45 lines (30 loc) · 4.23 KB
/
description.ru.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
---
name: Сигнатура функции
theory: |
Функция `Math.pow()`, возводящая число в какую-нибудь степень, принимает два параметра: **какое число возводить** и **в какую степень возводить**. Если вызывать `pow()` без параметров, то вернется `NaN`. Функция честно пытается выполнить возведение в степень, но если значение не передано, то интерпретатор автоматически передает ей `undefined`. JavaScript заставляет программистов быть более аккуратным, чем остальные языки. В большинстве языков, если передать в функцию меньше параметров, чем она ожидает, то возникнет ошибка, — но только не в JavaScript. `NaN` вернется и при передаче любых не числовых значений:
```javascript
const result = Math.pow(2, 'boom');
console.log(result); // => NaN
```
https://replit.com/@hexlet/js-basics-calling-functions-function-signature
Другая функция может иметь другое число параметров и другие типы параметров. Например, может существовать функция, которая принимает три параметра: число, строку и ещё одно число.
Откуда мы знаем, сколько каких параметров нужно функции `Math.pow()` и какого типа будет «возврат»? Мы заглянули в **сигнатуру** этой функции. Сигнатура определяет входные параметры и их типы, а также выходной параметр и его тип. Про функцию `Math.pow()` можно почитать в [документации](https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Math/pow). В разделе «Синтаксис» есть такой текст:
```
Math.pow(base, exponent)
Параметры
base
Основание степени.
exponent
Показатель степени, в которую возводится основание base.
```
Это сигнатура функции и короткое пояснение на русском языке. Документация позволяет понять, сколько аргументов у функции и какого они типа, возвращает ли что-то функция и если да, то какого типа возвращаемое значение.
instructions: |
Теперь ваша очередь посмотреть на сигнатуру функции в документации и разобраться, как её использовать. Можете читать документацию на русском языке, но программист должен уметь читать документацию на английском. Используйте словари или переводчики при необходимости. Лучше сразу привыкать и подтягивать навыки чтения на английском, иначе будут сложности в будущем.
В `Math` есть функция `ceil()`. Изучите её [документацию](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/ceil).
Напишите программу, которая использует функцию `Math.ceil()` с константой `number` и выводит результат на экран.
tips:
- |
[Сигнатура функции](https://developer.mozilla.org/en-US/docs/Glossary/Signature/Function)
definitions:
- name: Сигнатура функции
description: формальное описание типов параметров и типа возвращаемого значения функции.