🔖 Справочник синтаксиса

⚡ Кратко: справочник

Функция - именованный блок кода, который можно вызывать много раз.

def создаёт функцию, pass временно оставляет обязательный блок пустым.

При вызове функции позиционные аргументы сопоставляются по порядку, именованные - по названию параметра.

Аргументы по умолчанию пишутся после обязательных параметров.

*args собирает лишние позиционные аргументы в tuple, **kwargs - именованные аргументы в dict.

return завершает функцию и возвращает значение; без return результатом будет None.

LEGB описывает поиск имён: Local, Enclosing, Global, Built-in.

global нужен только для изменения глобальной переменной, но чаще лучше передавать данные параметрами.

Топ-3 ошибки: передавать не то количество аргументов; ожидать значение от функции, где нет return; менять global там, где достаточно параметров и return.

Конструкция	Для чего	Мини-пример
`def name(parameters):`	Определить пользовательскую функцию.	`def add(a, b):`
`pass`	Оставить пустой блок корректным.	`def TODO(): pass`
`function(value)`	Вызвать функцию.	`greet('Alice')`
`parameter=value`	Передать именованный аргумент.	`greet(age=30, name='Bob')`
`default='Hello'`	Задать значение по умолчанию.	`def greet(name, greeting='Hello'):`
`*args`	Принять любое количество позиционных аргументов.	`def total(*numbers):`
`**kwargs`	Принять любое количество именованных аргументов.	`def info(**fields):`
`return value`	Вернуть результат и завершить функцию.	`return a + b`
`global name`	Изменять глобальную переменную внутри функции.	`global counter`

Как пользоваться справочником

Копируйте не отдельную строку, а идею конструкции. В рабочем коде добавляйте понятные имена переменных, обработку некорректных входных данных и короткие функции с одним назначением.