Python: Функции
2026-02-26 20:07 Diff
https://ru.hexlet.io/courses/python-functions/lessons/keyword-arguments/theory_unit

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

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

Напомним, что параметры это имена в определении функции: x и y. А аргументы это значения, что подставляются при вызове. В этом случае с аргументами (10, 20) параметр x получит значение 10, а y — 20.

Но в Python у функций могут быть еще и именованные аргументы — keyword arguments. Их применять особенно удобно для вызова функций с множеством параметров одного типа.

Например, мы вызываем следующую функцию:

У функции calculate() три параметра - основное значение (base), значение, что вычитается и значение, на которое происходит умножение. При вызове этой функции, например calculate(10, 3, 2), может быть неочевидно сразу, где какой параметр, ведь их несколько и они одного, числового, типа.

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

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

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

Сравните с этим:

Такой код читать проще.

Значения параметров по умолчанию

Иногда в функции параметры задаются с одними и теми же значениями. Так функцией открытия файлов open() чаще открывают их в режиме чтения, а функция print() добавляет перенос строки. В такой ситуации удобно указать значения по умолчанию:

Изменяемые объекты как параметры по умолчанию

Python при использовании значений по умолчанию сохраняет их внутри объекта функции. При каждом вызове функции возвращаются сохраненные значения и подставляются в параметр.

Посмотреть сохраненные значения можно через метод __defaults__:

Потому важно не использовать изменяемые коллекции и объекты, ведь они будут сохранять все изменения между вызовами функции.

Правильным подходом будет создавать изменяемый объект в функции, а по умолчанию передавать None:

Keyword-only параметры

В Python есть возможность пометить параметры функции так, чтобы вызывать функцию можно было только передавая в них значения по именам. Такие параметры называются keyword-only, строго именованные, и в них нельзя передать позиционные аргументы. Выглядит функция с подобными параметрами так:

Здесь * выступает разделителем — отделяет обычные параметры от строго именованных. Такой разделитель можно использовать только один раз в одном определении. Также можно объявлять функции, у которых будут только строго именованные параметры. Для этого нужно поставить звездочку в самом начале перечня параметров.

Пример выше демонстрирует подход к описанию параметров. Первый параметр — имя файла, который будет открыт. Оно всегда присутствует и связано по смыслу с именем функции. Поэтому этот параметр можно не именовать. А writable и binary — необязательные параметры, которые получают значения True/False. Если бы их передавали без указания имени, то было бы непонятно какой к чему относится. Поэтому опции и объявлены так, что могут быть указаны только явно и по имени.

Выводы

В этом уроке мы узнали, что у функций в Python кроме позиционных есть еще и именованные аргументы. Также мы научились использовать их. Они нужны, когда мы хотим изменить порядок размещения передаваемых аргументов.

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