def function_name(param1, param2):
"""Описание функции.
:param param1: Описание первого параметра.
:param param2: Описание второго параметра.
:return: Описание возвращаемого значения.
"""
pass
Функция help()
Синтаксис
Описание
help()
Интерактивный справочный режим.
help(sum)
Справка по встроенной функции.
help(str)
Справка по типу и его методам.
help(greet)
Справка по пользовательской функции.
Аннотации типов
Конструкция
Пример
Пояснение
Параметр
def f(x: int)
Аргумент x ожидается целым числом.
Возвращаемое значение
def f() -> str
Функция должна вернуть строку.
Переменная
name: str = "Alice"
Переменная ожидается строкой.
Список
items: list[int]
Список целых чисел.
Словарь
data: dict[str, int]
Словарь со строковыми ключами и целыми значениями.
Кортеж фиксированной длины
point: tuple[int, int]
Кортеж из двух целых чисел.
Множество
tags: set[str]
Множество строк.
Без возврата
def log(msg: str) -> None
Функция ничего не возвращает.
⚠️ Проверить по документации: для сложных типов (Union, Optional, Callable, TypeVar) используется модуль typing. Подробности см. в официальной документации.
Операции со словарями
Операция
Пример
Результат
Инверсия
{v: k for k, v in d.items()}
Меняет ключи и значения местами.
Замена значений
{k: mapping.get(v, v) for k, v in d.items()}
Заменяет значения по другому словарю.
Проверка ключа
"key" in d
True, если ключ есть.
Безопасное получение
d.get("key", default)
Возвращает значение или default.
Обновление
d.update({"a": 1})
Добавляет или заменяет пары.
Шаблон рекурсивной функции
def recursive(args):
if base_condition(args): # базовый случай
return base_value
return recursive(smaller_args) # рекурсивный случай