generated from hexlet-basics/exercises-template
-
Notifications
You must be signed in to change notification settings - Fork 3
/
description.ru.yml
38 lines (23 loc) · 4.01 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
---
name: Сигнатура функции
theory: |
Функция `pow()` возводит число в степень. Она принимает два параметра: **какое число возводить** и **в какую степень возводить**. Если вызывать `pow()` без параметров, то Python выдаст следующее: `"TypeError: pow expected at least 2 arguments, got 0"`. Интерпретатор сообщает, что функция ожидает два параметра, а вы вызвали ее без них.
Функция `pow()` всегда имеет два обязательных параметра, поэтому ее невозможно вызвать с другим количеством параметров.
Более того, параметрами `pow()` могут быть только числа. Например, если передать в нее пару строк, это приведет к следующей ошибке: `"TypeError: unsupported operand type(s) for ** or pow(): 'str' and 'str'"`. Результат вызова функции — тоже всегда число.
Другая функция может иметь другое число параметров и другие типы параметров. Например, может существовать функция, которая принимает три параметра: число, строку и еще одно число.
Чтобы знать такие подробности о конкретной функции, нужно изучать ее **сигнатуру**. Она определяет входные параметры и их типы, а также выходной параметр и его тип. Про функцию `pow()` можно почитать в [официальной документации Python](https://docs.python.org/3/library/functions.html?highlight=pow#pow) или в [неофициальной документации на русском языке](https://docs-python.ru/tutorial/vstroennye-funktsii-interpretatora-python/funktsija-pow/). Обычно документация для функции выглядит так:
```
pow(x, y[, z])
Возвращает x в степени y; если z присутствует, возвращает x в степени y, по модулю z
```
Первая строка здесь — это сигнатура функции. У функции два обязательных параметра — `x` и `y`. Необязательный параметр `z` указан в квадратных скобках. Следом поясняется, для чего функция нужна. Документация дает понять, сколько аргументов у функции и какого они типа. Также она описывает, что возвращает функция и какого типа будет возвращаемое значение.
instructions: |
Теперь ваша очередь посмотреть на сигнатуру функции в документации и разобраться, как её использовать.
В Python есть функция `hex()`. Изучите её сигнатуру на [странице документации](https://docs-python.ru/tutorial/vstroennye-funktsii-interpretatora-python/funktsija-hex/).
Напишите программу, которая выведет на экран результат работы функции `hex()` с переменной `number` в качестве параметра.
tips:
- |
[Функция pow()](https://docs.python.org/3/library/functions.html?highlight=pow#pow)
definitions:
- name: Сигнатура функции
description: формальное описание типов аргументов и типа возвращаемого значения функции.