expressions.md
1> **Источник:** https://python-all.ru/3/reference/expressions.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 6. Выражения89В этой главе объясняется значение элементов выражений в Python.1011**Примечания по синтаксису:** В этой и следующих главах [грамматическая нотация](https://python-all.ru/3/reference/introduction.html#notation) будет использоваться для описания синтаксиса, а не лексического анализа.1213Когда (одна из альтернатив) синтаксического правила имеет вид:1415```1617name: othername18```1920и семантика не указана, то семантика этой формы `name` такая же, как для `othername`.2122## 6.1. Арифметические преобразования2324Когда в описании арифметического оператора ниже используется фраза «числовые аргументы преобразуются к общему вещественному типу», это означает, что реализация оператора для встроенных числовых типов работает так, как описано в разделе [Числовые типы](https://python-all.ru/3/library/stdtypes.html#stdtypes-mixed-arithmetic) документации стандартной библиотеки.2526Некоторые дополнительные правила применяются к определённым операторам и нечисловым операндам (например, строка в качестве левого аргумента оператора `%`). Расширения должны определять собственное поведение преобразования.2728## 6.2. Атомы2930Атомы – это самые базовые элементы выражений. Простейшие атомы – это [имена](https://python-all.ru/3/reference/lexical_analysis.html#identifiers) или литералы. Формы, заключённые в круглые, квадратные или фигурные скобки, также синтаксически относятся к атомам.3132Формально синтаксис атомов выглядит так:3334```3536atom:37 | 'True'38 | 'False'39 | 'None'40 | '...'41 | identifier42 | literal43 | enclosure44enclosure:45 | parenth_form46 | list_display47 | dict_display48 | set_display49 | generator_expression50 | yield_atom51```5253### 6.2.1. Встроенные константы5455Ключевые слова `True`, `False` и `None` обозначают [встроенные константы](https://python-all.ru/3/library/constants.html#built-in-consts). Токен `...` обозначает константу [`Ellipsis`](https://python-all.ru/3/library/constants.html#Ellipsis).5657Вычисление этих атомов даёт соответствующее значение.5859> **Примечание**60>61> Есть ещё несколько встроенных констант, доступных как глобальные переменные, но только упомянутые здесь являются [ключевыми словами](https://python-all.ru/3/reference/lexical_analysis.html#keywords). В частности, эти имена нельзя переопределять или использовать как атрибуты:62>63> ```pycon64> >>> False = 12365> File "<input>", line 166> False = 12367> ^^^^^68> SyntaxError: cannot assign to False69> ```7071### 6.2.2. Идентификаторы (Имена)7273Идентификатор, выступающий в роли атома, является именем. См. раздел [Имена (идентификаторы и ключевые слова)](https://python-all.ru/3/reference/lexical_analysis.html#identifiers) для лексического определения и раздел [Именование и связывание](https://python-all.ru/3/reference/executionmodel.html#naming) для документации по именованию и связыванию.7475Когда имя привязано к объекту, вычисление атома возвращает этот объект. Когда имя не привязано, попытка его вычисления вызывает [`NameError`](https://python-all.ru/3/library/exceptions.html#NameError) исключение.7677#### 6.2.2.1. Преобразование приватных имён7879Когда идентификатор, текстуально встречающийся в определении класса, начинается с двух или более символов подчёркивания и не заканчивается двумя или более подчёркиваниями, он считается *приватным именем* этого класса.8081> **См. также**82>83> [Спецификации классов](https://python-all.ru/3/reference/compound_stmts.html#class).8485Более точно, приватные имена преобразуются в более длинную форму до генерации кода. Если преобразованное имя длиннее 255 символов, может произойти усечение, определяемое реализацией.8687Преобразование не зависит от синтаксического контекста, в котором используется идентификатор, но только следующие приватные идентификаторы преобразуются:8889- Любое имя, используемое как имя переменной, которой присваивается значение или которая читается, или любое имя атрибута, к которому осуществляется доступ.9091 Однако атрибут [`__name__`](https://python-all.ru/3/library/stdtypes.html#definition.__name__) вложенных функций, классов и псевдонимов типов не преобразуется.92- Имя импортированных модулей, например, `__spam` в `import __spam`. Если модуль является частью пакета (т.е. его имя содержит точку), то имя *не* преобразуется, например, `__foo` в `import __foo.bar` не преобразуется.93- Имя импортированного члена, например, `__f` в `from spam import __f`.9495Правило преобразования определяется следующим образом:9697- Имя класса с удалёнными начальными подчёркиваниями и одним вставленным начальным подчёркиванием добавляется перед идентификатором, например, идентификатор `__spam`, встречающийся в классе с именем `Foo`, `_Foo` или `__Foo`, преобразуется в `_Foo__spam`.98- Если имя класса состоит только из подчёркиваний, преобразование не выполняется – например, идентификатор `__spam` в классе с именем `_` или `__` остаётся без изменений.99100### 6.2.3. Литералы101102*Литерал* – это текстовое представление значения. Python поддерживает числовые, строковые и байтовые литералы. [Форматированные строки](https://python-all.ru/3/reference/lexical_analysis.html#f-strings) и [шаблонные строки](https://python-all.ru/3/reference/lexical_analysis.html#t-strings) считаются строковыми литералами.103104Числовые литералы состоят из одного токена [`NUMBER`](https://python-all.ru/3/reference/lexical_analysis.html#grammar-token-python-grammar-NUMBER), который задаёт целое число, число с плавающей точкой или комплексное число. Подробнее см. раздел [Числовые литералы](https://python-all.ru/3/reference/lexical_analysis.html#numbers) в документации по лексическому анализу.105106Строковые и байтовые литералы могут состоять из нескольких токенов. Подробнее см. раздел [Конкатенация строковых литералов](https://python-all.ru/3/reference/expressions.html#string-concatenation).107108Обратите внимание: отрицательные и комплексные числа, такие как `-3` или `3+4.2j`, синтаксически не являются литералами, а представляют собой [унарные](https://python-all.ru/3/reference/expressions.html#unary) или [бинарные](https://python-all.ru/3/reference/expressions.html#binary) арифметические операции с операторами `-` или `+`.109110Вычисление литерала возвращает объект заданного типа ([`int`](https://python-all.ru/3/library/functions.html#int), [`float`](https://python-all.ru/3/library/functions.html#float), [`complex`](https://python-all.ru/3/library/functions.html#complex), [`str`](https://python-all.ru/3/library/stdtypes.html#str), [`bytes`](https://python-all.ru/3/library/stdtypes.html#bytes) или [`Template`](https://python-all.ru/3/library/string.templatelib.html#string.templatelib.Template)) с соответствующим значением. Для литералов с плавающей точкой и комплексных литералов значение может быть приближённым.111112Формальная грамматика литералов:113114```115116literal: strings | NUMBER117```118119#### 6.2.3.1. Литералы и тождественность объектов120121Все литералы соответствуют неизменяемым типам данных, поэтому тождественность объекта менее важна, чем его значение. При многократном вычислении литералов с одинаковым значением (одного и того же или разных вхождений в тексте программы) может получаться как один и тот же объект, так и разные объекты с одним и тем же значением.122123> **Особенность реализации CPython**124>125> Например, в CPython *малые* целые числа с одинаковым значением вычисляются в один и тот же объект:126>127> ```python128> >>> x = 7129> >>> y = 7130> >>> x is y131> True132> ```133>134> Однако большие целые числа вычисляются в разные объекты:135>136> ```python137> >>> x = 123456789138> >>> y = 123456789139> >>> x is y140> False141> ```142>143> Такое поведение может измениться в будущих версиях CPython. В частности, граница между «малыми» и «большими» целыми числами уже менялась в прошлом.144>145> CPython выдаёт предупреждение [`SyntaxWarning`](https://python-all.ru/3/library/exceptions.html#SyntaxWarning) при сравнении литералов с помощью `is`:146>147> ```python148> >>> x = 7149> >>> x is 7150> <input>:1: SyntaxWarning: "is" with 'int' literal. Did you mean "=="?151> True152> ```153>154> Дополнительную информацию см. в разделе [Когда можно полагаться на проверки тождественности с оператором is?](https://python-all.ru/3/faq/programming.html#faq-identity-with-is).155156[Шаблонные строки](https://python-all.ru/3/reference/lexical_analysis.html#t-strings) неизменяемы, но могут ссылаться на изменяемые объекты в качестве значений [`Interpolation`](https://python-all.ru/3/library/string.templatelib.html#string.templatelib.Interpolation). Для целей данного раздела две t-строки считаются имеющими «одинаковое значение», если совпадают как их структура, так и *тождественность* значений.157158**Особенность реализации CPython:** В настоящее время каждое вычисление шаблонной строки приводит к созданию нового объекта.159160#### 6.2.3.2. Конкатенация строковых литералов161162Допускается несколько расположенных рядом строковых или байтовых литералов, возможно, с разными кавычками; их значение равно результату конкатенации:163164```python165>>> "hello" 'world'166"helloworld"167```168169Эта возможность определена на синтаксическом уровне, поэтому работает только с литералами. Для конкатенации строковых выражений во время выполнения можно использовать оператор «+»:170171```python172>>> greeting = "Hello"173>>> space = " "174>>> name = "Blaise"175>>> print(greeting + space + name) # не: print(greeting space name)176Hello Blaise177```178179Конкатенация литералов свободно сочетает неформатированные строки, строки в тройных кавычках и форматированные строковые литералы. Например:180181```python182>>> "Hello" r', ' f"{name}!"183"Hello, Blaise!"184```185186Эту возможность можно использовать для уменьшения количества обратных слешей, для удобного разделения длинных строк на несколько строк или даже для добавления комментариев к частям строки. Например:187188```python189re.compile("[A-Za-z_]" # буква или подчёркивание190 "[A-Za-z0-9_]*" # буква, цифра или подчёркивание191 )192```193194Однако байтовые литералы можно объединять только с другими байтовыми литералами – не со строковыми литералами любого вида. Также шаблонные строковые литералы можно объединять только с другими шаблонными строковыми литералами:195196```python197>>> t"Hello" t"{name}!"198Template(strings=('Hello', '!'), interpolations=(...))199```200201Формально:202203```204205strings: (STRING | fstring)+ | tstring+206```207208### 6.2.4. Выражения в скобках209210Выражение в скобках – это необязательный список выражений, заключённый в круглые скобки:211212```213214parenth_form: "(" [starred_expression] ")"215```216217Вычисление списка выражений в скобках даёт результат этого списка: если список содержит хотя бы одну запятую, получается кортеж; в противном случае – единственное выражение, из которого состоит список.218219Пустая пара скобок даёт пустой кортеж. Поскольку кортежи неизменяемы, действуют те же правила, что и для литералов (два вхождения пустого кортежа могут как совпадать, так и не совпадать как объекты).220221Обратите внимание: кортежи образуются не скобками, а запятой. Исключение – пустой кортеж, для которого скобки *обязательны*: разрешить выражение без скобок, означающее «ничего», привело бы к двусмысленности и позволило бы типичным опечаткам остаться незамеченными.222223### 6.2.5. Отображения для списков, множеств и словарей224225Для создания списка, множества или словаря в Python предусмотрен специальный синтаксис, называемый «отображениями» (displays); каждый из них существует в двух вариантах:226227- либо содержимое контейнера перечисляется явно, либо228- они вычисляются с помощью набора инструкций циклов и фильтрации, называемого *включением (comprehension)*.229230Общие синтаксические элементы для включений:231232```233234comprehension: assignment_expression comp_for235comp_for: ["async"] "for" target_list "in" or_test [comp_iter]236comp_iter: comp_for | comp_if237comp_if: "if" or_test [comp_iter]238```239240Включение состоит из одного выражения, за которым следует по крайней мере одно предложение `for` и ноль или более предложений `for` или `if`. В этом случае элементами нового контейнера будут те, которые получаются при рассмотрении каждого из предложений `for` или `if` как блока, с вложением слева направо, и вычислении выражения для получения элемента каждый раз, когда достигается самый внутренний блок.241242Однако, за исключением итерируемого выражения в самом левом предложении `for`, включение выполняется в отдельной неявно вложенной области видимости. Это гарантирует, что имена, присваиваемые в целевом списке, не «утекают» в окружающую область.243244Итерируемое выражение в самом левом предложении `for` вычисляется непосредственно в окружающей области видимости, а затем передаётся как аргумент в неявно вложенную область. Последующие предложения `for` и любое условие фильтрации в самом левом предложении `for` не могут быть вычислены в окружающей области, поскольку они могут зависеть от значений, полученных из самого левого итерируемого объекта. Например: `[x*y for x in range(10) for y in range(x, x+10)]`.245246Чтобы гарантировать, что включение всегда даёт контейнер соответствующего типа, выражения `yield` и `yield from` запрещены в неявно вложенной области видимости.247248Начиная с Python 3.6, в функции [`async def`](https://python-all.ru/3/reference/compound_stmts.html#async-def) предложение `async for` может использоваться для итерации по [асинхронному итератору](https://python-all.ru/3/glossary.html#term-asynchronous-iterator). Включение в функции `async def` может состоять из предложения `for` или `async for` после ведущего выражения, может содержать дополнительные предложения `for` или `async for`, а также может использовать выражения [`await`](https://python-all.ru/3/reference/expressions.html#await).249250Если включение содержит предложения `async for`, или содержит выражения `await` или другие асинхронные включения где-либо, кроме итерируемого выражения в самом левом предложении `for`, оно называется *асинхронным включением*. Асинхронное включение может приостанавливать выполнение корутинной функции, в которой оно находится. См. также [**PEP 530**](https://python-all.ru/3/reference/expressions.html).251252Добавлено в версии 3.6: Были введены асинхронные включения.253254Изменено в версии 3.8: `yield` и `yield from` запрещены в неявно вложенной области видимости.255256Изменено в версии 3.11: Асинхронные включения теперь разрешены внутри включений в асинхронных функциях. Внешние включения неявно становятся асинхронными.257258### 6.2.6. Списковые отображения259260Списковое отображение – это возможно пустая последовательность выражений, заключённая в квадратные скобки:261262```263264list_display: "[" [flexible_expression_list | comprehension] "]"265```266267Списковое отображение возвращает новый объект списка, содержимое которого задаётся либо списком выражений, либо включением. Если предоставлен разделённый запятыми список выражений, его элементы вычисляются слева направо и помещаются в объект списка в том же порядке. Если предоставлено включение, список строится из элементов, полученных в результате включения.268269### 6.2.7. Множественные отображения270271Множественное отображение обозначается фигурными скобками и отличается от словарных отображений отсутствием двоеточий, разделяющих ключи и значения:272273```274275set_display: "{" (flexible_expression_list | comprehension) "}"276```277278Множественное отображение возвращает новый изменяемый объект множества, содержимое которого задаётся либо последовательностью выражений, либо включением. Если предоставлен разделённый запятыми список выражений, его элементы вычисляются слева направо и добавляются в объект множества. Если предоставлено включение, множество строится из элементов, полученных в результате включения.279280Пустое множество нельзя создать с помощью `{}`; этот литерал создаёт пустой словарь.281282### 6.2.8. Словарные отображения283284Словарное отображение – это возможно пустая последовательность элементов словаря (пар ключ/значение), заключённая в фигурные скобки:285286```287288dict_display: "{" [dict_item_list | dict_comprehension] "}"289dict_item_list: dict_item ("," dict_item)* [","]290dict_item: expression ":" expression | "**" or_expr291dict_comprehension: expression ":" expression comp_for292```293294Словарное отображение возвращает новый объект словаря.295296Если дана разделённая запятыми последовательность элементов словаря, они вычисляются слева направо для определения записей словаря: каждый объект ключа используется как ключ в словаре для хранения соответствующего значения. Это означает, что можно указать один и тот же ключ несколько раз в списке элементов словаря, и итоговым значением словаря для этого ключа будет последнее указанное.297298Двойная звёздочка `**` обозначает *распаковку словаря*. Её операндом должно быть [отображение (mapping)](https://python-all.ru/3/glossary.html#term-mapping). Каждый элемент отображения добавляется в новый словарь. Более поздние значения заменяют значения, уже установленные более ранними элементами словаря и более ранними распаковками словарей.299300Добавлено в версии 3.5: Распаковка в словарные отображения, изначально предложенная в [**PEP 448**](https://python-all.ru/3/reference/expressions.html).301302Словарное включение, в отличие от списковых и множественных включений, требует двух выражений, разделённых двоеточием, после которых следуют обычные предложения «for» и «if». При выполнении включения результирующие элементы ключей и значений вставляются в новый словарь в порядке их получения.303304Ограничения на типы ключевых значений перечислены ранее в разделе [Стандартная иерархия типов](https://python-all.ru/3/reference/datamodel.html#types). (Если кратко, тип ключа должен быть [хэшируемым](https://python-all.ru/3/glossary.html#term-hashable), что исключает все изменяемые объекты.) Коллизии между дублирующимися ключами не обнаруживаются; сохраняется последнее значение (текстуально самое правое в отображении), сохранённое для данного ключа.305306Изменено в версии 3.8: До Python 3.8 в словарных включениях порядок вычисления ключа и значения не был строго определён. В CPython значение вычислялось раньше ключа. Начиная с версии 3.8, ключ вычисляется раньше значения, как предложено в [**PEP 572**](https://python-all.ru/3/reference/expressions.html).307308### 6.2.9. Генераторные выражения309310Синтаксис для *генераторных выражений* такой же, как для [списковых включений](https://python-all.ru/3/reference/expressions.html#comprehensions), за исключением того, что они заключаются в круглые скобки вместо квадратных. Например:311312```python313>>> iterator = (x ** 2 for x in range(10))314>>> iterator315<generator object <genexpr> at ...>316```317318Во время выполнения генераторное выражение вычисляется в [итератор-генератор](https://python-all.ru/3/glossary.html#term-generator-iterator), который возвращает те же значения, что и соответствующее списковое включение:319320```python321>>> list(iterator)322[0, 1, 4, 9, 16, 25, 36, 49, 64, 81]323```324325Таким образом, пример выше примерно эквивалентен определению и вызову следующей генераторной функции:326327```python328def make_generator_of_squares(iterator):329 for x in iterator:330 yield x ** 2331332make_generator_of_squares(iter(range(10)))333```334335The enclosing parentheses can be omitted in calls when the generator expression is the only positional argument and there are no keyword arguments. See the [Calls section](https://python-all.ru/3/reference/expressions.html#calls) for details. For example:336337```python338# Круглые скобки после `sum` являются частью синтаксиса вызова:339>>> sum(x ** 2 for x in range(10))340285341342# Генератор требует собственных круглых скобок, если он не единственный аргумент:343>>> sum((x ** 2 for x in range(10)), start=1000)3441285345```346347Итерируемое выражение в крайнем слева предложении `for` вычисляется немедленно, поэтому ошибка, возникшая в этом выражении, будет выдана в точке определения generator-выражения, а не в точке, где запрашивается первое значение:348349```python350>>> (x ** 2 for x in nonexistent_iterable)351Traceback (most recent call last):352 ...353NameError: name 'nonexistent_iterable' is not defined354```355356После вычисления выражения из результата создаётся итератор, как если бы для него вызвали [`iter()`](https://python-all.ru/3/library/functions.html#iter). Любая ошибка, возникшая при создании итератора, также выдается немедленно:357358```python359>>> (x ** 2 for x in None)360Traceback (most recent call last):361 ...362TypeError: 'NoneType' object is not iterable363```364365Все остальные выражения вычисляются лениво, так же как и обычные генераторы (то есть когда у итератора запрашивается очередное значение):366367```python368>>> iterator = (nonexistent_value for x in range(10))369>>> iterator370<generator object <genexpr> at ...>371>>> list(iterator)372Traceback (most recent call last):373 ...374NameError: name 'nonexistent_value' is not defined375```376377```python378>>> iterator = (x * y for x in range(10) for y in nonexistent_iterable)379>>> iterator380<generator object <genexpr> at ...>381>>> list(iterator)382Traceback (most recent call last):383 ...384NameError: name 'nonexistent_iterable' is not defined385```386387Чтобы не нарушать ожидаемую работу самого generator-выражения, выражения `yield` и `yield from` запрещены внутри неявно вложенной области видимости.388389Если generator-выражение содержит предложения `async for` или выражения [`await`](https://python-all.ru/3/reference/expressions.html#await), оно называется *асинхронным generator-выражением*. Асинхронное generator-выражение возвращает новый асинхронный объект-генератор, который является асинхронным итератором (см. [Асинхронные итераторы](https://python-all.ru/3/reference/datamodel.html#async-iterators)).390391Формальная грамматика generator-выражений:392393```394395generator_expression: "(" expression comp_for ")"396```397398Добавлено в версии 3.6: Появились асинхронные generator-выражения.399400Изменено в версии 3.7: До Python 3.7 асинхронные generator-выражения могли появляться только в корутинах [`async def`](https://python-all.ru/3/reference/compound_stmts.html#async-def). Начиная с версии 3.7 любая функция может использовать асинхронные generator-выражения.401402Изменено в версии 3.8: `yield` и `yield from` запрещены в неявно вложенной области видимости.403404### 6.2.10. Выражения yield405406```407408yield_atom: "(" yield_expression ")"409yield_from: "yield" "from" expression410yield_expression: "yield" yield_list | yield_from411```412413The yield expression is used when defining a [generator](https://python-all.ru/3/glossary.html#term-generator) function or an [asynchronous generator](https://python-all.ru/3/glossary.html#term-asynchronous-generator) function and thus can only be used in the body of a function definition. Using a yield expression in a function’s body causes that function to be a generator function, and using it in an [`async def`](https://python-all.ru/3/reference/compound_stmts.html#async-def) function’s body causes that coroutine function to be an asynchronous generator function. For example:414415```python416def gen(): # определяет функцию-генератор417 yield 123418419async def agen(): # определяет асинхронную функцию-генератор420 yield 123421```422423Из-за побочных эффектов на содержащую область видимости, выражения `yield` не допускаются как часть неявно определённых областей видимости, используемых для реализации включений и generator-выражений.424425Изменено в версии 3.8: Выражения yield запрещены в неявно вложенных областях видимости, используемых для реализации включений и generator-выражений.426427Generator functions are described below, while asynchronous generator functions are described separately in section [Asynchronous generator functions](https://python-all.ru/3/reference/expressions.html#asynchronous-generator-functions).428429При вызове функции-генератора она возвращает итератор, известный как generator. Этот generator затем управляет выполнением функции-генератора. Выполнение начинается, когда вызывается один из методов generator. В этот момент выполнение доходит до первого выражения yield, где оно снова приостанавливается, возвращая значение [`yield_list`](https://python-all.ru/3/reference/expressions.html#grammar-token-python-grammar-yield_list) вызывающему generator, или `None`, если `yield_list` опущено. Под приостановкой подразумевается, что всё локальное состояние сохраняется, включая текущие привязки локальных переменных, указатель команд, внутренний стек вычислений и состояние обработки исключений. Когда выполнение возобновляется вызовом одного из методов generator, функция продолжается точно так, как если бы выражение yield было просто ещё одним внешним вызовом. Значение выражения yield после возобновления зависит от метода, который возобновил выполнение. Если используется [`__next__()`](https://python-all.ru/3/reference/expressions.html#generator.__next__) (обычно через [`for`](https://python-all.ru/3/reference/compound_stmts.html#for) или встроенную функцию [`next()`](https://python-all.ru/3/library/functions.html#next)), то результатом будет [`None`](https://python-all.ru/3/library/constants.html#None). В противном случае, если используется [`send()`](https://python-all.ru/3/reference/expressions.html#generator.send), то результатом будет значение, переданное этому методу.430431Всё это делает функции-генераторы весьма похожими на корутины; они могут выдавать значения несколько раз, имеют более одной точки входа, и их выполнение может быть приостановлено. Единственное отличие в том, что функция-генератор не может управлять тем, где должно продолжиться выполнение после yield; управление всегда передаётся вызывающему generator.432433Выражения yield разрешены в любом месте конструкции [`try`](https://python-all.ru/3/reference/compound_stmts.html#try). Если generator не возобновляется до его завершения (достижение нулевого счётчика ссылок или сборка мусора), будет вызван метод [`close()`](https://python-all.ru/3/reference/expressions.html#generator.close) generator-итератора, что позволит выполнить все ожидающие предложения [`finally`](https://python-all.ru/3/reference/compound_stmts.html#finally).434435При использовании `yield from <expr>` переданное выражение должно быть итерируемым объектом. Значения, полученные при итерации этого итерируемого объекта, передаются напрямую вызывающему методов текущего generator. Любые значения, переданные через [`send()`](https://python-all.ru/3/reference/expressions.html#generator.send), и любые исключения, переданные через [`throw()`](https://python-all.ru/3/reference/expressions.html#generator.throw), передаются базовому итератору, если у него есть соответствующие методы. Если это не так, то `send()` возбудит [`AttributeError`](https://python-all.ru/3/library/exceptions.html#AttributeError) или [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError), в то время как `throw()` просто немедленно возбудит переданное исключение.436437Когда базовый итератор завершён, атрибут [`value`](https://python-all.ru/3/library/exceptions.html#StopIteration.value) возбуждённого экземпляра [`StopIteration`](https://python-all.ru/3/library/exceptions.html#StopIteration) становится значением выражения yield. Он может быть установлен явно при возбуждении `StopIteration` или автоматически, когда под-итератор является generator (путём возврата значения из под-генератора).438439Изменено в версии 3.3: Добавлено `yield from <expr>` для делегирования потока управления под-итератору.440441Круглые скобки могут быть опущены, когда выражение yield является единственным выражением в правой части оператора присваивания.442443> **См. также**444>445> **[**PEP 255**](https://python-all.ru/3/reference/expressions.html) - Simple Generators**446>447> Предложение по добавлению генераторов и оператора [`yield`](https://python-all.ru/3/reference/simple_stmts.html#yield) в Python.448>449> **[**PEP 342**](https://python-all.ru/3/reference/expressions.html) - Coroutines via Enhanced Generators**450>451> Предложение по улучшению API и синтаксиса генераторов, позволяющее использовать их как простые корутины.452>453> **[**PEP 380**](https://python-all.ru/3/reference/expressions.html) - Syntax for Delegating to a Subgenerator**454>455> Предложение по введению синтаксиса [`yield_from`](https://python-all.ru/3/reference/expressions.html#grammar-token-python-grammar-yield_from), упрощающее делегирование под-генераторам.456>457> **[**PEP 525**](https://python-all.ru/3/reference/expressions.html) - Asynchronous Generators**458>459> The proposal that expanded on [**PEP 492**](https://python-all.ru/3/reference/expressions.html) by adding generator capabilities to coroutine functions.460461#### 6.2.10.1. Методы generator-итератора462463В этом подразделе описаны методы итератора генератора. Они могут использоваться для управления выполнением генераторной функции.464465Обратите внимание, что вызов любого из приведённых ниже методов генератора, когда генератор уже выполняется, приводит к исключению [`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError).466467#### `generator.__next__()`468469Запускает выполнение генераторной функции или возобновляет его с последнего выполненного выражения yield. При возобновлении генераторной функции методом `__next__()` текущее выражение yield всегда вычисляется в [`None`](https://python-all.ru/3/library/constants.html#None). Затем выполнение продолжается до следующего выражения yield, на котором генератор снова приостанавливается, и значение [`yield_list`](https://python-all.ru/3/reference/expressions.html#grammar-token-python-grammar-yield_list) возвращается вызывающему коду `__next__()`. Если генератор завершается, не выдав следующего значения, возбуждается исключение [`StopIteration`](https://python-all.ru/3/library/exceptions.html#StopIteration).470471Обычно этот метод вызывается неявно, например, циклом [`for`](https://python-all.ru/3/reference/compound_stmts.html#for) или встроенной функцией [`next()`](https://python-all.ru/3/library/functions.html#next).472473#### `generator.send(value)`474475Возобновляет выполнение и «отправляет» значение в генераторную функцию. Аргумент *value* становится результатом текущего выражения yield. Метод `send()` возвращает следующее значение, выданное генератором, или возбуждает [`StopIteration`](https://python-all.ru/3/library/exceptions.html#StopIteration), если генератор завершается, не выдав другого значения. При вызове `send()` для запуска генератора его необходимо вызывать с аргументом [`None`](https://python-all.ru/3/library/constants.html#None), так как нет выражения yield, которое могло бы получить значение.476477#### `generator.throw(value)`478479#### `generator.throw(type[, value[, traceback]])`480481Возбуждает исключение в точке, где генератор был приостановлен, и возвращает следующее значение, выданное генераторной функцией. Если генератор завершается, не выдав другого значения, возбуждается исключение [`StopIteration`](https://python-all.ru/3/library/exceptions.html#StopIteration). Если генераторная функция не перехватывает переданное исключение или возбуждает другое исключение, то это исключение распространяется на вызывающий код.482483Обычно этот метод вызывается с одним экземпляром исключения, подобно тому, как используется ключевое слово [`raise`](https://python-all.ru/3/reference/simple_stmts.html#raise).484485Однако для обратной совместимости поддерживается вторая сигнатура, следуя соглашению из более старых версий Python. Аргумент *type* должен быть классом исключения, а *value* – экземпляром исключения. Если *value* не указан, вызывается конструктор *type* для получения экземпляра. Если *traceback* предоставлен, он устанавливается в исключении, в противном случае любой существующий атрибут [`__traceback__`](https://python-all.ru/3/library/exceptions.html#BaseException.__traceback__), хранящийся в *value*, может быть очищен.486487Изменено в версии 3.12: Вторая сигнатура (type\[, value\[, traceback\]\]) устарела и может быть удалена в будущей версии Python.488489#### `generator.close()`490491Возбуждает исключение [`GeneratorExit`](https://python-all.ru/3/library/exceptions.html#GeneratorExit) в точке, где генераторная функция была приостановлена (эквивалентно вызову `throw(GeneratorExit)`). Исключение возбуждается выражением yield, на котором генератор был приостановлен. Если генераторная функция перехватывает исключение и возвращает значение, это значение возвращается из `close()`. Если генераторная функция уже закрыта или возбуждает `GeneratorExit` (не перехватывая исключение), `close()` возвращает [`None`](https://python-all.ru/3/library/constants.html#None). Если генератор выдает значение, возбуждается [`RuntimeError`](https://python-all.ru/3/library/exceptions.html#RuntimeError). Если генератор возбуждает любое другое исключение, оно распространяется на вызывающий код. Если генератор уже завершился из-за исключения или нормального завершения, `close()` возвращает `None` и не имеет других эффектов.492493Изменено в версии 3.13: Если генератор возвращает значение при закрытии, это значение возвращается методом `close()`.494495#### 6.2.10.2. Примеры496497Вот простой пример, демонстрирующий поведение генераторов и генераторных функций:498499```python500>>> def echo(value=None):501... print("Execution starts when 'next()' is called for the first time.")502... try:503... while True:504... try:505... value = (yield value)506... except Exception as e:507... value = e508... finally:509... print("Don't forget to clean up when 'close()' is called.")510...511>>> generator = echo(1)512>>> print(next(generator))513Execution starts when 'next()' is called for the first time.5141515>>> print(next(generator))516None517>>> print(generator.send(2))5182519>>> generator.throw(TypeError, "spam")520TypeError('spam',)521>>> generator.close()522Don't forget to clean up when 'close()' is called.523```524525Примеры использования `yield from` см. в [PEP 380: Syntax for Delegating to a Subgenerator](https://python-all.ru/3/whatsnew/3.3.html#pep-380) в разделе «What’s New in Python».526527#### 6.2.10.3. Асинхронные генераторные функции528529Наличие выражения yield в функции или методе, определённом с помощью [`async def`](https://python-all.ru/3/reference/compound_stmts.html#async-def), дополнительно определяет функцию как [асинхронный генератор](https://python-all.ru/3/glossary.html#term-asynchronous-generator).530531При вызове асинхронной генераторной функции она возвращает асинхронный итератор, известный как объект асинхронного генератора. Этот объект затем управляет выполнением генераторной функции. Объект асинхронного генератора обычно используется в инструкции [`async for`](https://python-all.ru/3/reference/compound_stmts.html#async-for) внутри корутинной функции, аналогично тому, как объект генератора используется в инструкции [`for`](https://python-all.ru/3/reference/compound_stmts.html#for).532533Вызов одного из методов асинхронного генератора возвращает [ожидаемый объект](https://python-all.ru/3/glossary.html#term-awaitable), и выполнение начинается, когда этот объект ожидается. В этот момент выполнение переходит к первому выражению yield, где оно снова приостанавливается, возвращая значение [`yield_list`](https://python-all.ru/3/reference/expressions.html#grammar-token-python-grammar-yield_list) ожидающей корутине. Как и в случае с генератором, приостановка означает, что всё локальное состояние сохраняется, включая текущие привязки локальных переменных, указатель инструкций, внутренний стек вычислений и состояние обработки исключений. Когда выполнение возобновляется путём ожидания следующего объекта, возвращённого методами асинхронного генератора, функция может продолжить работу точно так, как если бы выражение yield было просто ещё одним внешним вызовом. Значение выражения yield после возобновления зависит от метода, который возобновил выполнение. Если используется [`__anext__()`](https://python-all.ru/3/reference/expressions.html#agen.__anext__), то результатом будет [`None`](https://python-all.ru/3/library/constants.html#None). В противном случае, если используется [`asend()`](https://python-all.ru/3/reference/expressions.html#agen.asend), то результатом будет значение, переданное этому методу.534535Если асинхронный генератор завершается досрочно из-за [`break`](https://python-all.ru/3/reference/simple_stmts.html#break), отмены задачи вызывающего кода или других исключений, запускается код асинхронной очистки генератора, который может возбудить исключения или получить доступ к переменным контекста в неожиданном контексте – возможно, после завершения времени жизни задач, от которых он зависит, или во время завершения цикла событий, когда вызывается сборщик мусора асинхронных генераторов. Чтобы предотвратить это, вызывающий код должен явно закрыть асинхронный генератор, вызвав метод [`aclose()`](https://python-all.ru/3/reference/expressions.html#agen.aclose) для финализации генератора и окончательного отсоединения его от цикла событий.536537В асинхронной генераторной функции выражения yield разрешены в любом месте конструкции [`try`](https://python-all.ru/3/reference/compound_stmts.html#try). Однако если асинхронный генератор не был возобновлён до финализации (достижение нулевого счётчика ссылок или сборка мусора), то выражение yield внутри конструкции `try` может привести к невозможности выполнить ожидающие предложения [`finally`](https://python-all.ru/3/reference/compound_stmts.html#finally). В этом случае цикл событий или планировщик, выполняющий асинхронный генератор, должен вызвать метод [`aclose()`](https://python-all.ru/3/reference/expressions.html#agen.aclose) итератора асинхронного генератора и запустить полученный объект корутины, чтобы позволить выполниться ожидающим предложениям `finally`.538539Чтобы обеспечить финализацию при завершении цикла событий, цикл событий должен определить функцию *финализатор*, которая принимает итератор асинхронного генератора и, предположительно, вызывает [`aclose()`](https://python-all.ru/3/reference/expressions.html#agen.aclose) и выполняет корутину. Этот *финализатор* может быть зарегистрирован вызовом [`sys.set_asyncgen_hooks()`](https://python-all.ru/3/library/sys.html#sys.set_asyncgen_hooks). При первой итерации итератор асинхронного генератора сохранит зарегистрированный *финализатор* для вызова при финализации. Пример реализации метода *финализатор* см. в реализации `asyncio.Loop.shutdown_asyncgens` в [Lib/asyncio/base\_events.py](https://python-all.ru/src/3.14/Lib/asyncio/base_events.py).540541Выражение `yield from <expr>` является синтаксической ошибкой при использовании в асинхронной генераторной функции.542543#### 6.2.10.4. Методы итератора асинхронного генератора544545В этом подразделе описаны методы итератора асинхронного генератора, которые используются для управления выполнением генераторной функции.546547#### `async agen.__anext__()`548549Возвращает ожидаемый объект, который при выполнении запускает асинхронный генератор или возобновляет его с последнего выполненного выражения yield. Когда асинхронная генераторная функция возобновляется методом `__anext__()`, текущее выражение yield всегда вычисляется в [`None`](https://python-all.ru/3/library/constants.html#None) в возвращаемом ожидаемом объекте, который при выполнении продолжает работу до следующего выражения yield. Значение [`yield_list`](https://python-all.ru/3/reference/expressions.html#grammar-token-python-grammar-yield_list) выражения yield - это значение исключения [`StopIteration`](https://python-all.ru/3/library/exceptions.html#StopIteration), возбуждённого завершаемой корутиной. Если асинхронный генератор завершается, не выдав другого значения, ожидаемый объект вместо этого возбуждает исключение [`StopAsyncIteration`](https://python-all.ru/3/library/exceptions.html#StopAsyncIteration), сигнализируя о завершении асинхронной итерации.550551Обычно этот метод вызывается неявно циклом [`async for`](https://python-all.ru/3/reference/compound_stmts.html#async-for).552553#### `async agen.asend(value)`554555Возвращает ожидаемый объект, который при запуске возобновляет выполнение асинхронного генератора. Как и в случае метода [`send()`](https://python-all.ru/3/reference/expressions.html#generator.send) для генератора, этот «отправляет» значение в асинхронную функцию-генератор, и аргумент *value* становится результатом текущего выражения yield. Ожидаемый объект, возвращённый методом `asend()`, вернёт следующее значение, выданное генератором, как значение возбуждённого [`StopIteration`](https://python-all.ru/3/library/exceptions.html#StopIteration), или возбуждает [`StopAsyncIteration`](https://python-all.ru/3/library/exceptions.html#StopAsyncIteration), если асинхронный генератор завершится, не выдав другого значения. Когда `asend()` вызывается для запуска асинхронного генератора, он должен быть вызван с аргументом [`None`](https://python-all.ru/3/library/constants.html#None), потому что нет выражения yield, которое могло бы получить значение.556557#### `async agen.athrow(value)`558559#### `async agen.athrow(type[, value[, traceback]])`560561Возвращает ожидаемый объект, который возбуждает исключение типа `type` в точке, где асинхронный генератор был приостановлен, и возвращает следующее значение, выданное функцией-генератором, как значение возбуждённого исключения [`StopIteration`](https://python-all.ru/3/library/exceptions.html#StopIteration). Если асинхронный генератор завершается, не выдав другого значения, ожидаемый объект возбуждает исключение [`StopAsyncIteration`](https://python-all.ru/3/library/exceptions.html#StopAsyncIteration). Если функция-генератор не перехватывает переданное исключение или возбуждает другое исключение, то при запуске ожидаемого объекта это исключение распространяется на вызывающую сторону.562563Изменено в версии 3.12: Вторая сигнатура (type\[, value\[, traceback\]\]) является устаревшей и может быть удалена в будущей версии Python.564565#### `async agen.aclose()`566567Возвращает ожидаемый объект, который при запуске вызовет [`GeneratorExit`](https://python-all.ru/3/library/exceptions.html#GeneratorExit) в асинхронную функцию-генератор в точке, где она была приостановлена. Если асинхронная функция-генератор затем завершается нормально, уже закрыта или возбуждает `GeneratorExit` (не перехватив исключение), то возвращаемый ожидаемый объект возбудит исключение [`StopIteration`](https://python-all.ru/3/library/exceptions.html#StopIteration). Любые последующие ожидаемые объекты, возвращённые вызовами асинхронного генератора, будут возбуждать исключение [`StopAsyncIteration`](https://python-all.ru/3/library/exceptions.html#StopAsyncIteration). Если асинхронный генератор выдаёт значение, ожидаемый объект возбуждает [`RuntimeError`](https://python-all.ru/3/library/exceptions.html#RuntimeError). Если асинхронный генератор возбуждает любое другое исключение, оно распространяется на вызывающую сторону ожидаемого объекта. Если асинхронный генератор уже завершился по причине исключения или нормального завершения, то последующие вызовы `aclose()` возвратят ожидаемый объект, который ничего не делает.568569## 6.3. Первичные выражения570571Первичные выражения представляют операции с самой высокой связностью в языке. Их синтаксис:572573```574575primary: atom | attributeref | subscription | call576```577578### 6.3.1. Ссылки на атрибуты579580Ссылка на атрибут – это первичное выражение, за которым следуют точка и имя:581582```583584attributeref: primary "." identifier585```586587Первичное выражение должно вычисляться в объект типа, поддерживающего ссылки на атрибуты (большинство объектов это делают). Затем у этого объекта запрашивается атрибут с указанным идентификатором. Тип и значение полученного атрибута определяются объектом. При многократных вычислениях одной и той же ссылки на атрибут могут получаться разные объекты.588589Это поведение можно настроить, переопределив метод [`__getattribute__()`](https://python-all.ru/3/reference/datamodel.html#object.__getattribute__) или метод [`__getattr__()`](https://python-all.ru/3/reference/datamodel.html#object.__getattr__). Сначала вызывается метод `__getattribute__()`, который либо возвращает значение, либо возбуждает [`AttributeError`](https://python-all.ru/3/library/exceptions.html#AttributeError), если атрибут недоступен.590591Если возбуждено [`AttributeError`](https://python-all.ru/3/library/exceptions.html#AttributeError) и у объекта есть метод `__getattr__()`, этот метод вызывается как запасной вариант.592593### 6.3.2. Извлечение элементов и срезы594595Синтаксис *извлечения элемента* обычно используется для выбора элемента из [контейнера](https://python-all.ru/3/reference/datamodel.html#sequence-types) – например, для получения значения из [`dict`](https://python-all.ru/3/library/stdtypes.html#dict):596597```python598>>> digits_by_name = {'one': 1, 'two': 2}599>>> digits_by_name['two'] # Индексирование словаря по ключу 'two'6002601```602603В синтаксисе извлечения элемента объект, из которого извлекается элемент – [первичное выражение](https://python-all.ru/3/reference/expressions.html#primaries) – за которым следует *подписка* в квадратных скобках. В простейшем случае подписка представляет собой одно выражение.604605В зависимости от типа объекта, из которого извлекается элемент, подписка иногда называется [ключом](https://python-all.ru/3/glossary.html#term-key) (для отображений), [индексом](https://python-all.ru/3/glossary.html#term-index) (для последовательностей) или *аргументом типа* (для [обобщённых типов](https://python-all.ru/3/glossary.html#term-generic-type)). Синтаксически все они эквивалентны:606607```python608>>> colors = ['red', 'blue', 'green', 'black']609>>> colors[3] # Индексирование списка по индексу 3610'black'611612>>> list[str] # Параметризация типа списка с помощью аргумента типа str613list[str]614```615616Во время выполнения интерпретатор вычисляет первичное выражение и подписку, и вызывает [`__getitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__getitem__) или [`__class_getitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__class_getitem__) [специальный метод](https://python-all.ru/3/glossary.html#term-special-method) первичного выражения с подпиской в качестве аргумента. Подробнее о том, какой из этих методов вызывается, см. в [\_\_class\_getitem\_\_ и \_\_getitem\_\_](https://python-all.ru/3/reference/datamodel.html#classgetitem-versus-getitem).617618Чтобы показать, как работает извлечение элемента, можно определить пользовательский объект, реализующий [`__getitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__getitem__) и выводящий значение подписки:619620```python621>>> class SubscriptionDemo:622... def __getitem__(self, key):623... print(f'subscripted with: {key!r}')624...625>>> demo = SubscriptionDemo()626>>> demo[1]627subscripted with: 1628>>> demo['a' * 3]629subscripted with: 'aaa'630```631632См. документацию [`__getitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__getitem__) о том, как встроенные типы обрабатывают извлечение элемента.633634Извлечение элемента также может использоваться как цель в операторах [присваивания](https://python-all.ru/3/reference/simple_stmts.html#assignment) или [удаления](https://python-all.ru/3/reference/simple_stmts.html#del). В этих случаях интерпретатор вызывает соответственно [`__setitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__setitem__) или [`__delitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__delitem__) [специальный метод](https://python-all.ru/3/glossary.html#term-special-method) объекта, у которого извлекается элемент, вместо [`__getitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__getitem__).635636```python637>>> colors = ['red', 'blue', 'green', 'black']638>>> colors[3] = 'white' # Установка элемента по индексу639>>> colors640['red', 'blue', 'green', 'white']641>>> del colors[3] # Удаление элемента по индексу 3642>>> colors643['red', 'blue', 'green']644```645646Все расширенные формы *подписки*, описанные в следующих разделах, также применимы для присваивания и удаления.647648#### 6.3.2.1. Срезы649650Более продвинутая форма извлечения элемента – *срез* – обычно используется для извлечения части [последовательности](https://python-all.ru/3/reference/datamodel.html#datamodel-sequences). В этой форме подписка представляет собой [срез](https://python-all.ru/3/glossary.html#term-slice): до трёх выражений, разделённых двоеточиями. Любое из выражений может быть опущено, но срез должен содержать хотя бы одно двоеточие:651652```python653>>> number_names = ['zero', 'one', 'two', 'three', 'four', 'five']654>>> number_names[1:3]655['one', 'two']656>>> number_names[1:]657['one', 'two', 'three', 'four', 'five']658>>> number_names[:3]659['zero', 'one', 'two']660>>> number_names[:]661['zero', 'one', 'two', 'three', 'four', 'five']662>>> number_names[::2]663['zero', 'two', 'four']664>>> number_names[:-3]665['zero', 'one', 'two']666>>> del number_names[4:]667>>> number_names668['zero', 'one', 'two', 'three']669```670671Когда срез вычисляется, интерпретатор создаёт объект [`slice`](https://python-all.ru/3/library/functions.html#slice), чьи атрибуты [`start`](https://python-all.ru/3/library/functions.html#slice.start), [`stop`](https://python-all.ru/3/library/functions.html#slice.stop) и [`step`](https://python-all.ru/3/library/functions.html#slice.step) соответственно являются результатами выражений между двоеточиями. Любое пропущенное выражение вычисляется в [`None`](https://python-all.ru/3/library/constants.html#None). Затем этот объект `slice` передаётся методу [`__getitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__getitem__) или [`__class_getitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__class_getitem__) [специальный метод](https://python-all.ru/3/glossary.html#term-special-method), как указано выше.672673```python674# продолжение с экземпляром SubscriptionDemo, определённым выше:675>>> demo[2:3]676subscripted with: slice(2, 3, None)677>>> demo[::'spam']678subscripted with: slice(None, None, 'spam')679```680681#### 6.3.2.2. Подписки, разделённые запятыми682683Подписка также может быть задана в виде двух или более выражений или срезов, разделённых запятыми:684685```python686# продолжение с экземпляром SubscriptionDemo, определённым выше:687>>> demo[1, 2, 3]688subscripted with: (1, 2, 3)689>>> demo[1:2, 3]690subscripted with: (slice(1, 2, None), 3)691```692693Эта форма обычно используется в числовых библиотеках для нарезки многомерных данных. В этом случае интерпретатор создаёт [`tuple`](https://python-all.ru/3/library/stdtypes.html#tuple) из результатов выражений или срезов и передаёт этот кортеж методу [`__getitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__getitem__) или [`__class_getitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__class_getitem__) [специальный метод](https://python-all.ru/3/glossary.html#term-special-method), как указано выше.694695Подписка также может быть задана в виде одного выражения или среза, за которым следует запятая, чтобы указать кортеж из одного элемента:696697```python698>>> demo['spam',]699subscripted with: ('spam',)700```701702#### 6.3.2.3. Подписки со звёздочкой703704Добавлено в версии 3.11: Выражения в *tuple\_slices* могут содержать звёздочку. См. [**PEP 646**](https://python-all.ru/3/reference/expressions.html).705706Индекс также может содержать выражение со звёздочкой. В этом случае интерпретатор распаковывает результат в кортеж и передаёт этот кортеж в [`__getitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__getitem__) или [`__class_getitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__class_getitem__):707708```python709# продолжение с экземпляром SubscriptionDemo, определённым выше:710>>> demo[*range(10)]711subscripted with: (0, 1, 2, 3, 4, 5, 6, 7, 8, 9)712```713714Выражения со звёздочкой можно комбинировать с выражениями, разделёнными запятыми, и срезами:715716```python717>>> demo['a', 'b', *range(3), 'c']718subscripted with: ('a', 'b', 0, 1, 2, 'c')719```720721#### 6.3.2.4. Формальная грамматика индексирования722723```724725subscription: primary '[' subscript ']'726subscript: single_subscript | tuple_subscript727single_subscript: proper_slice | assignment_expression728proper_slice: [expression] ":" [expression] [ ":" [expression] ]729tuple_subscript: ','.(single_subscript | starred_expression)+ [',']730```731732Напомним, что оператор `|` [обозначает упорядоченный выбор](https://python-all.ru/3/reference/introduction.html#notation). В частности, в `subscript`, если обе альтернативы совпадают, приоритет имеет первая (`single_subscript`).733734### 6.3.3. Вызовы735736Вызов – это обращение к вызываемому объекту (например, [функции](https://python-all.ru/3/glossary.html#term-function)) с возможно пустой последовательностью [аргументов](https://python-all.ru/3/glossary.html#term-argument):737738```739740call: primary "(" [argument_list [","] | comprehension] ")"741argument_list: positional_arguments ["," starred_and_keywords]742 ["," keywords_arguments]743 | starred_and_keywords ["," keywords_arguments]744 | keywords_arguments745positional_arguments: positional_item ("," positional_item)*746positional_item: assignment_expression | "*" expression747starred_and_keywords: ("*" expression | keyword_item)748 ("," "*" expression | "," keyword_item)*749keywords_arguments: (keyword_item | "**" expression)750 ("," keyword_item | "," "**" expression)*751keyword_item: identifier "=" expression752```753754После позиционных и именованных аргументов может стоять необязательная завершающая запятая, но на семантику это не влияет.755756Первичное выражение должно принимать значение вызываемого объекта (вызываемыми являются: функции, определённые пользователем, встроенные функции, методы встроенных объектов, объекты классов, методы экземпляров классов и все объекты, имеющие метод [`__call__()`](https://python-all.ru/3/reference/datamodel.html#object.__call__)). Все выражения аргументов вычисляются до попытки вызова. За синтаксисом списков формальных [параметров](https://python-all.ru/3/glossary.html#term-parameter) обращайтесь к разделу [Определения функций](https://python-all.ru/3/reference/compound_stmts.html#function).757758Если присутствуют именованные аргументы, они сначала преобразуются в позиционные следующим образом. Сначала создаётся список незаполненных слотов для формальных параметров. Если есть N позиционных аргументов, они помещаются в первые N слотов. Затем для каждого именованного аргумента идентификатор используется для определения соответствующего слота (если идентификатор совпадает с именем первого формального параметра, используется первый слот и так далее). Если слот уже занят, возбуждается исключение [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError). В противном случае аргумент помещается в слот, заполняя его (даже если выражение равно `None`, оно заполняет слот). Когда все аргументы обработаны, слоты, которые всё ещё не заполнены, заполняются соответствующим значением по умолчанию из определения функции. (Значения по умолчанию вычисляются один раз при определении функции; таким образом, изменяемый объект, такой как список или словарь, используемый в качестве значения по умолчанию, будет общим для всех вызовов, которые не указывают значение аргумента для соответствующего слота; этого обычно следует избегать.) Если остались незаполненные слоты, для которых не указано значение по умолчанию, возбуждается исключение `TypeError`. В противном случае список заполненных слотов используется как список аргументов для вызова.759760**Особенность реализации CPython:** Реализация может предоставлять встроенные функции, чьи позиционные параметры не имеют имён, даже если они «названы» для целей документации, и поэтому их нельзя передать по ключевому слову. В CPython это относится к функциям, реализованным на C, которые используют [`PyArg_ParseTuple()`](https://python-all.ru/3/c-api/arg.html#c.PyArg_ParseTuple) для разбора своих аргументов.761762Если позиционных аргументов больше, чем слотов формальных параметров, возбуждается исключение [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError), если только не присутствует формальный параметр с синтаксисом `*identifier`; в этом случае этот формальный параметр получает кортеж, содержащий лишние позиционные аргументы (или пустой кортеж, если лишних позиционных аргументов не было).763764Если какой-либо именованный аргумент не соответствует имени формального параметра, возбуждается исключение [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError), если только не присутствует формальный параметр с синтаксисом `**identifier`; в этом случае этот формальный параметр получает словарь, содержащий лишние именованные аргументы (с ключами в качестве имён и значениями аргументов в качестве соответствующих значений), или (новый) пустой словарь, если лишних именованных аргументов не было.765766Если в вызове функции присутствует синтаксис `*expression`, `expression` должен принимать значение [итерируемого объекта](https://python-all.ru/3/glossary.html#term-iterable). Элементы из этих итерируемых объектов рассматриваются как дополнительные позиционные аргументы. Для вызова `f(x1, x2, *y, x3, x4)`, если *y* принимает значение последовательности *y1*, …, *yM*, это эквивалентно вызову с M+4 позиционными аргументами *x1*, *x2*, *y1*, …, *yM*, *x3*, *x4*.767768Следствием этого является то, что хотя синтаксис `*expression` может появляться *после* явных именованных аргументов, он обрабатывается *до* именованных аргументов (и любых аргументов `**expression` – см. ниже). Итак:769770```python771>>> def f(a, b):772... print(a, b)773...774>>> f(b=1, *(2,))7752 1776>>> f(a=1, *(2,))777Traceback (most recent call last):778 File "<stdin>", line 1, in <module>779TypeError: f() got multiple values for keyword argument 'a'780>>> f(1, *(2,))7811 2782```783784Обычно именованные аргументы и синтаксис `*expression` не используются в одном вызове, поэтому на практике такая путаница возникает редко.785786Если в вызове функции присутствует синтаксис `**expression`, `expression` должен принимать значение [отображения](https://python-all.ru/3/glossary.html#term-mapping), содержимое которого рассматривается как дополнительные именованные аргументы. Если параметру, соответствующему ключу, уже было присвоено значение (явным именованным аргументом или из другой распаковки), возбуждается исключение [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError).787788При использовании `**expression` каждый ключ в этом отображении должен быть строкой. Каждое значение из отображения присваивается первому формальному параметру, доступному для присваивания по ключевому слову, чьё имя равно ключу. Ключ не обязательно должен быть идентификатором Python (например, `"max-temp °F"` допустимо, хотя он не будет соответствовать ни одному формальному параметру, который можно объявить). Если соответствия формальному параметру нет, пара ключ-значение собирается параметром `**`, если он есть, или, если его нет, возбуждается исключение [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError).789790Формальные параметры с синтаксисом `*identifier` или `**identifier` не могут использоваться как слоты позиционных аргументов или как имена именованных аргументов.791792Изменено в версии 3.5: Вызовы функций принимают любое количество распаковок `*` и `**`, позиционные аргументы могут следовать за распаковками итерируемых объектов (`*`), а именованные аргументы – за распаковками словарей (`**`). Изначально предложено в [**PEP 448**](https://python-all.ru/3/reference/expressions.html).793794Вызов всегда возвращает некоторое значение, возможно `None`, если только не возбуждается исключение. Как вычисляется это значение, зависит от типа вызываемого объекта.795796Если это–797798**пользовательская функция:**799800Выполняется блок кода функции, которому передаётся список аргументов. Первое, что делает блок кода, – связывает формальные параметры с аргументами; это описано в разделе [Определения функций](https://python-all.ru/3/reference/compound_stmts.html#function). Когда блок кода выполняет оператор [`return`](https://python-all.ru/3/reference/simple_stmts.html#return), он задаёт возвращаемое значение вызова функции. Если выполнение достигает конца блока кода без выполнения оператора `return`, возвращаемое значение равно `None`.801802**встроенная функция или метод:**803804Результат зависит от интерпретатора; описания встроенных функций и методов см. в [Встроенные функции](https://python-all.ru/3/library/functions.html#built-in-funcs).805806**объект класса:**807808Возвращается новый экземпляр этого класса.809810**метод экземпляра класса:**811812Вызывается соответствующая пользовательская функция, со списком аргументов, который на один длиннее списка аргументов вызова: экземпляр становится первым аргументом.813814**экземпляр класса:**815816Класс должен определять метод [`__call__()`](https://python-all.ru/3/reference/datamodel.html#object.__call__); результат будет таким же, как если бы был вызван этот метод.817818## 6.4. Выражение await819820Приостанавливает выполнение [корутины](https://python-all.ru/3/glossary.html#term-coroutine) на [ожидаемом объекте](https://python-all.ru/3/glossary.html#term-awaitable). Может использоваться только внутри [корутинной функции](https://python-all.ru/3/glossary.html#term-coroutine-function).821822```823824await_expr: "await" primary825```826827Добавлено в версии 3.5.828829## 6.5. Оператор возведения в степень830831Оператор возведения в степень имеет более высокий приоритет, чем унарные операторы слева, и более низкий приоритет, чем унарные операторы справа. Синтаксис:832833```834835power: (await_expr | primary) ["**" u_expr]836```837838Таким образом, в последовательности операторов возведения в степень и унарных операторов без скобок операторы вычисляются справа налево (это не накладывает ограничений на порядок вычисления операндов): `-1**2` даёт `-1`.839840Оператор возведения в степень имеет ту же семантику, что и встроенная функция [`pow()`](https://python-all.ru/3/library/functions.html#pow), вызванная с двумя аргументами: он возвращает левый аргумент, возведённый в степень правого аргумента. Числовые аргументы сначала [преобразуются к общему типу](https://python-all.ru/3/library/stdtypes.html#stdtypes-mixed-arithmetic), и результат имеет этот тип.841842Для операндов типа int результат имеет тот же тип, что и операнды, если только второй аргумент не отрицателен; в этом случае все аргументы преобразуются в float и возвращается результат типа float. Например, `10**2` возвращает `100`, но `10**-2` возвращает `0.01`.843844Возведение `0.0` в отрицательную степень приводит к [`ZeroDivisionError`](https://python-all.ru/3/library/exceptions.html#ZeroDivisionError). Возведение отрицательного числа в дробную степень даёт [`complex`](https://python-all.ru/3/library/functions.html#complex) число. (В более ранних версиях это вызывало [`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError).)845846Эту операцию можно настроить с помощью специальных методов [`__pow__()`](https://python-all.ru/3/reference/datamodel.html#object.__pow__) и [`__rpow__()`](https://python-all.ru/3/reference/datamodel.html#object.__rpow__).847848## 6.6. Унарные арифметические и побитовые операции849850Все унарные арифметические и побитовые операции имеют одинаковый приоритет:851852```853854u_expr: power | "-" u_expr | "+" u_expr | "~" u_expr855```856857Унарный оператор `-` (минус) возвращает отрицание своего числового аргумента; эту операцию можно переопределить с помощью специального метода [`__neg__()`](https://python-all.ru/3/reference/datamodel.html#object.__neg__).858859Унарный оператор `+` (плюс) возвращает свой числовой аргумент без изменений; эту операцию можно переопределить с помощью специального метода [`__pos__()`](https://python-all.ru/3/reference/datamodel.html#object.__pos__).860861Унарный оператор `~` (инверсия) возвращает побитовую инверсию своего целочисленного аргумента. Побитовая инверсия `x` определяется как `-(x+1)`. Он применим только к целым числам или пользовательским объектам, переопределяющим специальный метод [`__invert__()`](https://python-all.ru/3/reference/datamodel.html#object.__invert__).862863Во всех трёх случаях, если аргумент имеет неправильный тип, вызывается исключение [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError).864865## 6.7. Бинарные арифметические операции866867Бинарные арифметические операции имеют общепринятые уровни приоритета. Обратите внимание, что некоторые из этих операций также применимы к некоторым нечисловым типам. За исключением оператора возведения в степень, существует только два уровня: один для мультипликативных операторов и один для аддитивных операторов:868869```870871m_expr: u_expr | m_expr "*" u_expr | m_expr "@" m_expr |872 m_expr "//" u_expr | m_expr "/" u_expr |873 m_expr "%" u_expr874a_expr: m_expr | a_expr "+" m_expr | a_expr "-" m_expr875```876877Оператор `*` (умножение) возвращает произведение своих аргументов. Аргументы должны быть либо оба числами, либо один аргумент – целым числом, а другой – последовательностью. В первом случае числа [преобразуются к общему вещественному типу](https://python-all.ru/3/library/stdtypes.html#stdtypes-mixed-arithmetic), а затем перемножаются. Во втором случае выполняется повторение последовательности; отрицательный коэффициент повторения даёт пустую последовательность.878879Эту операцию можно настроить с помощью специальных методов [`__mul__()`](https://python-all.ru/3/reference/datamodel.html#object.__mul__) и [`__rmul__()`](https://python-all.ru/3/reference/datamodel.html#object.__rmul__).880881Изменено в версии 3.14: Если только один операнд является комплексным числом, другой операнд преобразуется в число с плавающей точкой.882883Оператор `@` (at) предназначен для умножения матриц. Ни один встроенный тип Python не реализует этот оператор.884885Эту операцию можно настроить с помощью специальных методов [`__matmul__()`](https://python-all.ru/3/reference/datamodel.html#object.__matmul__) и [`__rmatmul__()`](https://python-all.ru/3/reference/datamodel.html#object.__rmatmul__).886887Добавлено в версии 3.5.888889Операторы `/` (деление) и `//` (целочисленное деление) возвращают частное своих аргументов. Числовые аргументы сначала [преобразуются к общему типу](https://python-all.ru/3/library/stdtypes.html#stdtypes-mixed-arithmetic). Деление целых чисел даёт float, а целочисленное деление целых чисел даёт целое число; результат представляет собой математическое деление с применением функции 'floor' к результату. Деление на ноль вызывает исключение [`ZeroDivisionError`](https://python-all.ru/3/library/exceptions.html#ZeroDivisionError).890891Операцию деления можно настроить с помощью специальных методов [`__truediv__()`](https://python-all.ru/3/reference/datamodel.html#object.__truediv__) и [`__rtruediv__()`](https://python-all.ru/3/reference/datamodel.html#object.__rtruediv__). Операцию целочисленного деления можно настроить с помощью специальных методов [`__floordiv__()`](https://python-all.ru/3/reference/datamodel.html#object.__floordiv__) и [`__rfloordiv__()`](https://python-all.ru/3/reference/datamodel.html#object.__rfloordiv__).892893Оператор `%` (остаток от деления) возвращает остаток от деления первого аргумента на второй. Числовые аргументы сначала [преобразуются к общему типу](https://python-all.ru/3/library/stdtypes.html#stdtypes-mixed-arithmetic). Нулевой правый аргумент вызывает исключение [`ZeroDivisionError`](https://python-all.ru/3/library/exceptions.html#ZeroDivisionError). Аргументы могут быть числами с плавающей точкой, например, `3.14%0.7` равно `0.34` (поскольку `3.14` равно `4*0.7 + 0.34`). Оператор остатка всегда возвращает результат с тем же знаком, что и второй операнд (или ноль); абсолютное значение результата строго меньше абсолютного значения второго операнда [\[1\]](https://python-all.ru/3/reference/expressions.html#id18).894895Операторы целочисленного деления и остатка связаны следующим тождеством: `x == (x//y)*y + (x%y)`. Целочисленное деление и остаток также связаны со встроенной функцией [`divmod()`](https://python-all.ru/3/library/functions.html#divmod): `divmod(x, y) == (x//y, x%y)`. [\[2\]](https://python-all.ru/3/reference/expressions.html#id19).896897Помимо выполнения операции взятия остатка над числами, оператор `%` также перегружается строковыми объектами для выполнения форматирования строк в старом стиле (также известного как интерполяция). Синтаксис форматирования строк описан в справочнике по библиотеке Python, раздел [Форматирование строк в стиле printf](https://python-all.ru/3/library/stdtypes.html#old-string-formatting).898899Операцию *взятия остатка* можно настроить с помощью специальных методов [`__mod__()`](https://python-all.ru/3/reference/datamodel.html#object.__mod__) и [`__rmod__()`](https://python-all.ru/3/reference/datamodel.html#object.__rmod__).900901Оператор целочисленного деления, оператор остатка и функция [`divmod()`](https://python-all.ru/3/library/functions.html#divmod) не определены для комплексных чисел. Вместо этого преобразуйте в число с плавающей точкой с помощью функции [`abs()`](https://python-all.ru/3/library/functions.html#abs), если это уместно.902903Оператор `+` (сложение) возвращает сумму своих аргументов. Аргументы должны быть либо оба числами, либо обеими последовательностями одного типа. В первом случае числа [преобразуются к общему вещественному типу](https://python-all.ru/3/library/stdtypes.html#stdtypes-mixed-arithmetic), а затем складываются. Во втором случае последовательности конкатенируются.904905Эту операцию можно настроить с помощью специальных методов [`__add__()`](https://python-all.ru/3/reference/datamodel.html#object.__add__) и [`__radd__()`](https://python-all.ru/3/reference/datamodel.html#object.__radd__).906907Изменено в версии 3.14: Если только один операнд является комплексным числом, другой операнд преобразуется в число с плавающей точкой.908909Оператор `-` (вычитание) возвращает разность своих аргументов. Числовые аргументы сначала [преобразуются к общему вещественному типу](https://python-all.ru/3/library/stdtypes.html#stdtypes-mixed-arithmetic).910911Эту операцию можно настроить с помощью специальных методов [`__sub__()`](https://python-all.ru/3/reference/datamodel.html#object.__sub__) и [`__rsub__()`](https://python-all.ru/3/reference/datamodel.html#object.__rsub__).912913Изменено в версии 3.14: Если только один операнд является комплексным числом, другой операнд преобразуется в число с плавающей запятой.914915## 6.8. Операции сдвига916917Операции сдвига имеют более низкий приоритет, чем арифметические операции:918919```920921shift_expr: a_expr | shift_expr ("<<" | ">>") a_expr922```923924Эти операторы принимают целые числа в качестве аргументов. Они сдвигают первый аргумент влево или вправо на количество бит, заданное вторым аргументом.925926Операцию левого сдвига можно настроить с помощью специальных методов [`__lshift__()`](https://python-all.ru/3/reference/datamodel.html#object.__lshift__) и [`__rlshift__()`](https://python-all.ru/3/reference/datamodel.html#object.__rlshift__). Операцию правого сдвига можно настроить с помощью специальных методов [`__rshift__()`](https://python-all.ru/3/reference/datamodel.html#object.__rshift__) и [`__rrshift__()`](https://python-all.ru/3/reference/datamodel.html#object.__rrshift__).927928Правый сдвиг на *n* бит определяется как целочисленное деление на `pow(2,n)`. Левый сдвиг на *n* бит определяется как умножение на `pow(2,n)`.929930## 6.9. Двоичные побитовые операции931932Каждая из трёх побитовых операций имеет свой уровень приоритета:933934```935936and_expr: shift_expr | and_expr "&" shift_expr937xor_expr: and_expr | xor_expr "^" and_expr938or_expr: xor_expr | or_expr "|" xor_expr939```940941Оператор `&` возвращает побитовое И (AND) своих аргументов, которые должны быть целыми числами, или один из них должен быть пользовательским объектом, переопределяющим специальные методы [`__and__()`](https://python-all.ru/3/reference/datamodel.html#object.__and__) или [`__rand__()`](https://python-all.ru/3/reference/datamodel.html#object.__rand__).942943Оператор `^` возвращает побитовое исключающее ИЛИ (XOR) своих аргументов, которые должны быть целыми числами, или один из них должен быть пользовательским объектом, переопределяющим специальные методы [`__xor__()`](https://python-all.ru/3/reference/datamodel.html#object.__xor__) или [`__rxor__()`](https://python-all.ru/3/reference/datamodel.html#object.__rxor__).944945Оператор `|` возвращает побитовое (включающее) ИЛИ (OR) своих аргументов, которые должны быть целыми числами, или один из них должен быть пользовательским объектом, переопределяющим специальные методы [`__or__()`](https://python-all.ru/3/reference/datamodel.html#object.__or__) или [`__ror__()`](https://python-all.ru/3/reference/datamodel.html#object.__ror__).946947## 6.10. Сравнения948949В отличие от C, все операции сравнения в Python имеют одинаковый приоритет, который ниже приоритета любых арифметических, сдвиговых или побитовых операций. Также в отличие от C, выражения вида `a < b < c` интерпретируются так, как принято в математике:950951```952953comparison: or_expr (comp_operator or_expr)*954comp_operator: "<" | ">" | "==" | ">=" | "<=" | "!="955 | "is" ["not"] | ["not"] "in"956```957958Сравнения возвращают логические значения: `True` или `False`. Пользовательские *методы расширенного сравнения* могут возвращать не-логические значения. В этом случае Python вызовет [`bool()`](https://python-all.ru/3/library/functions.html#bool) для такого значения в логических контекстах.959960Сравнения можно произвольно объединять в цепочки, например, `x < y <= z` эквивалентно `x < y and y <= z`, за исключением того, что `y` вычисляется только один раз (но в обоих случаях `z` вообще не вычисляется, если `x < y` оказывается ложным).961962Формально, если *a*, *b*, *c*, …, *y*, *z* – это выражения, а *op1*, *op2*, …, *opN* – операторы сравнения, то `a op1 b op2 c ... y opN z` эквивалентно `a op1 b and b op2 c and ... y opN z`, за исключением того, что каждое выражение вычисляется не более одного раза.963964Обратите внимание, что `a op1 b op2 c` не подразумевает никакого сравнения между *a* и *c*, так что, например, `x < y > z` совершенно допустимо (хотя, возможно, и некрасиво).965966### 6.10.1. Сравнения значений967968Операторы `<`, `>`, `==`, `>=`, `<=` и `!=` сравнивают значения двух объектов. Объекты не обязательно должны иметь одинаковый тип.969970В главе [Объекты, значения и типы](https://python-all.ru/3/reference/datamodel.html#objects) говорится, что объекты имеют значение (в дополнение к типу и идентичности). Значение объекта – довольно абстрактное понятие в Python: например, не существует канонического метода доступа к значению объекта. Также не требуется, чтобы значение объекта было сформировано определённым образом, например, из всех его атрибутов данных. Операторы сравнения реализуют определённое представление о том, что является значением объекта. Можно считать, что они косвенно определяют значение объекта через свою реализацию сравнения.971972Поскольку все типы являются (прямыми или косвенными) подтипами [`object`](https://python-all.ru/3/library/functions.html#object), они наследуют поведение сравнения по умолчанию от `object`. Типы могут настраивать своё поведение сравнения, реализуя *методы расширенного сравнения*, такие как [`__lt__()`](https://python-all.ru/3/reference/datamodel.html#object.__lt__), описанные в разделе [Базовая настройка](https://python-all.ru/3/reference/datamodel.html#customization).973974Поведение по умолчанию для сравнения на равенство (`==` и `!=`) основано на идентичности объектов. Следовательно, сравнение на равенство экземпляров с одинаковой идентичностью даёт равенство, а сравнение экземпляров с разной идентичностью – неравенство. Мотивация такого поведения по умолчанию – желание, чтобы все объекты были рефлексивными (т.е. `x is y` влечёт `x == y`).975976Поведение сравнения порядка по умолчанию (`<`, `>`, `<=` и `>=`) не предусмотрено; попытка вызывает [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError). Мотивация такого поведения по умолчанию – отсутствие аналогичного инварианта, как для равенства.977978Поведение сравнения на равенство по умолчанию, при котором экземпляры с разной идентичностью всегда неравны, может противоречить тому, что нужно типам, имеющим разумное определение значения объекта и равенства на основе значения. Таким типам потребуется настраивать своё поведение сравнения, и, в самом деле, ряд встроенных типов уже это сделал.979980Следующий список описывает поведение сравнения наиболее важных встроенных типов.981982- Числа встроенных числовых типов ([Числовые типы – int, float, complex](https://python-all.ru/3/library/stdtypes.html#typesnumeric)) и типов стандартной библиотеки [`fractions.Fraction`](https://python-all.ru/3/library/fractions.html#fractions.Fraction) и [`decimal.Decimal`](https://python-all.ru/3/library/decimal.html#decimal.Decimal) можно сравнивать как внутри своих типов, так и между ними, с ограничением, что комплексные числа не поддерживают сравнение порядка. В пределах задействованных типов они сравниваются математически (алгоритмически) корректно без потери точности.983984 Значения «не число» (NaN) `float('NaN')` и `decimal.Decimal('NaN')` являются особыми. Любое упорядоченное сравнение числа со значением «не число» даёт ложь. Контринтуитивное следствие: значения «не число» не равны сами себе. Например, если `x = float('NaN')`, `3 < x`, `x < 3` и `x == x` – все ложны, а `x != x` истинно. Это поведение соответствует стандарту IEEE 754.985- `None` и [`NotImplemented`](https://python-all.ru/3/library/constants.html#NotImplemented) – это синглтоны. [**PEP 8**](https://python-all.ru/3/reference/expressions.html) рекомендует всегда выполнять сравнения синглтонов с помощью `is` или `is not`, а не операторов равенства.986- Бинарные последовательности (экземпляры [`bytes`](https://python-all.ru/3/library/stdtypes.html#bytes) или [`bytearray`](https://python-all.ru/3/library/stdtypes.html#bytearray)) можно сравнивать как внутри своих типов, так и между ними. Они сравниваются лексикографически по числовым значениям своих элементов.987- Строки (экземпляры [`str`](https://python-all.ru/3/library/stdtypes.html#str)) сравниваются лексикографически по числовым кодовым точкам Unicode (результат встроенной функции [`ord()`](https://python-all.ru/3/library/functions.html#ord)) своих символов. [\[3\]](https://python-all.ru/3/reference/expressions.html#id20)988989 Строки и двоичные последовательности нельзя сравнивать напрямую.990- Последовательности (экземпляры [`tuple`](https://python-all.ru/3/library/stdtypes.html#tuple), [`list`](https://python-all.ru/3/library/stdtypes.html#list) или [`range`](https://python-all.ru/3/library/stdtypes.html#range)) можно сравнивать только внутри каждого из своих типов, с ограничением, что диапазоны не поддерживают сравнение порядка. Сравнение на равенство между этими типами даёт неравенство, а сравнение порядка между этими типами вызывает [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError).991992 Последовательности сравниваются лексикографически с помощью сравнения соответствующих элементов. Встроенные контейнеры обычно считают, что одинаковые объекты равны сами себе. Это позволяет им пропускать проверки на равенство для одинаковых объектов для повышения производительности и поддержания внутренних инвариантов.993994 Лексикографическое сравнение между встроенными коллекциями работает следующим образом:995996 - Чтобы две коллекции были равны при сравнении, они должны быть одного типа, иметь одинаковую длину, и каждая пара соответствующих элементов должна быть равной (например, `[1,2] == (1,2)` – ложь, так как типы разные).997 - Коллекции, поддерживающие сравнение порядка, упорядочиваются так же, как и их первые неравные элементы (например, `[1,2,x] <= [1,2,y]` имеет то же значение, что и `x <= y`). Если соответствующего элемента не существует, более короткая коллекция считается меньшей (например, `[1,2] < [1,2,3]` – истина).998- Отображения (экземпляры [`dict`](https://python-all.ru/3/library/stdtypes.html#dict)) равны тогда и только тогда, когда они имеют равные пары `(key, value)`. Сравнение ключей и значений на равенство требует рефлексивности.9991000 Сравнения порядка (`<`, `>`, `<=` и `>=`) вызывают [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError).1001- Множества (экземпляры [`set`](https://python-all.ru/3/library/stdtypes.html#set) или [`frozenset`](https://python-all.ru/3/library/stdtypes.html#frozenset)) можно сравнивать как внутри типа, так и между типами.10021003 Они определяют операторы сравнения порядка как проверки на подмножество и надмножество. Эти отношения не задают полного порядка (например, два множества `{1,2}` и `{2,3}` не равны, не являются подмножеством друг друга и не являются надмножеством друг друга). Соответственно, множества не подходят в качестве аргументов для функций, зависящих от полного порядка (например, [`min()`](https://python-all.ru/3/library/functions.html#min), [`max()`](https://python-all.ru/3/library/functions.html#max) и [`sorted()`](https://python-all.ru/3/library/functions.html#sorted) дают неопределённые результаты, если на вход подаётся список множеств).10041005 Сравнение множеств требует рефлексивности их элементов.1006- У большинства других встроенных типов нет реализованных методов сравнения, поэтому они наследуют поведение сравнения по умолчанию.10071008Пользовательские классы, которые настраивают своё поведение сравнения, должны по возможности следовать некоторым правилам согласованности:10091010- Сравнение на равенство должно быть рефлексивным. Другими словами, идентичные объекты должны быть равны:10111012 > `x is y` влечёт `x == y`1013- Сравнение должно быть симметричным. Другими словами, следующие выражения должны давать одинаковый результат:10141015 > `x == y` и `y == x`1016 >1017 > `x != y` и `y != x`1018 >1019 > `x < y` и `y > x`1020 >1021 > `x <= y` и `y >= x`1022- Сравнение должно быть транзитивным. Следующие (неисчерпывающие) примеры это иллюстрируют:10231024 > `x > y and y > z` влечёт `x > z`1025 >1026 > `x < y and y <= z` влечёт `x < z`1027- Обратное сравнение должно давать логическое отрицание. Другими словами, следующие выражения должны давать одинаковый результат:10281029 > `x == y` и `not x != y`1030 >1031 > `x < y` и `not x >= y` (для полного порядка)1032 >1033 > `x > y` и `not x <= y` (для полного порядка)10341035 Последние два выражения применимы к полностью упорядоченным коллекциям (например, к последовательностям, но не к множествам или отображениям). См. также декоратор [`total_ordering()`](https://python-all.ru/3/library/functools.html#functools.total_ordering).1036- Результат [`hash()`](https://python-all.ru/3/library/functions.html#hash) должен быть согласован с равенством. Объекты, которые равны, должны либо иметь одинаковое хеш-значение, либо быть помечены как нехешируемые.10371038Python не требует соблюдения этих правил согласованности. Фактически, значения «не число» (NaN) являются примером их нарушения.10391040### 6.10.2. Операции проверки принадлежности10411042Операторы [`in`](https://python-all.ru/3/reference/expressions.html#in) и [`not in`](https://python-all.ru/3/reference/expressions.html#not-in) проверяют принадлежность. `x in s` вычисляется в `True`, если *x* является элементом *s*, и `False` в противном случае. `x not in s` возвращает отрицание `x in s`. Все встроенные последовательности и множества поддерживают это, а также словари, для которых `in` проверяет, содержит ли словарь заданный ключ. Для контейнерных типов, таких как list, tuple, set, frozenset, dict или collections.deque, выражение `x in y` эквивалентно `any(x is e or x == e for e in y)`.10431044Для типов str и bytes `x in y` равно `True` тогда и только тогда, когда *x* является подстрокой *y*. Эквивалентная проверка: `y.find(x) != -1`. Пустые строки всегда считаются подстрокой любой другой строки, поэтому `"" in "abc"` вернёт `True`.10451046Для пользовательских классов, которые определяют метод [`__contains__()`](https://python-all.ru/3/reference/datamodel.html#object.__contains__), `x in y` возвращает `True`, если `y.__contains__(x)` возвращает истинное значение, и `False` в противном случае.10471048Для пользовательских классов, которые не определяют [`__contains__()`](https://python-all.ru/3/reference/datamodel.html#object.__contains__), но определяют [`__iter__()`](https://python-all.ru/3/reference/datamodel.html#object.__iter__), `x in y` равно `True`, если при итерации по `y` встречается некоторое значение `z`, для которого выражение `x is z or x == z` истинно. Если во время итерации возникает исключение, это равносильно тому, что [`in`](https://python-all.ru/3/reference/expressions.html#in) вызвало это исключение.10491050Наконец, используется протокол итерации старого стиля: если класс определяет [`__getitem__()`](https://python-all.ru/3/reference/datamodel.html#object.__getitem__), `x in y` равно `True` тогда и только тогда, когда существует неотрицательный целочисленный индекс *i*, такой что `x is y[i] or x == y[i]`, и ни один меньший индекс не вызывает исключение [`IndexError`](https://python-all.ru/3/library/exceptions.html#IndexError). (Если возникает любое другое исключение, это равносильно тому, что [`in`](https://python-all.ru/3/reference/expressions.html#in) вызвало это исключение).10511052Оператор [`not in`](https://python-all.ru/3/reference/expressions.html#not-in) определён так, что его истинностное значение противоположно [`in`](https://python-all.ru/3/reference/expressions.html#in).10531054### 6.10.3. Сравнение идентичности10551056Операторы [`is`](https://python-all.ru/3/reference/expressions.html#is) и [`is not`](https://python-all.ru/3/reference/expressions.html#is-not) проверяют идентичность объектов: `x is y` истинно тогда и только тогда, когда *x* и *y* являются одним и тем же объектом. Идентичность объекта определяется с помощью функции [`id()`](https://python-all.ru/3/library/functions.html#id). `x is not y` возвращает противоположное логическое значение. [\[4\]](https://python-all.ru/3/reference/expressions.html#id21)10571058## 6.11. Логические операции10591060```10611062or_test: and_test | or_test "or" and_test1063and_test: not_test | and_test "and" not_test1064not_test: comparison | "not" not_test1065```10661067В контексте логических операций, а также когда выражения используются в операторах управления потоком, следующие значения интерпретируются как ложные: `False`, `None`, числовой ноль всех типов, а также пустые строки и контейнеры (включая строки, кортежи, списки, словари, множества и неизменяемые множества). Все остальные значения интерпретируются как истинные. Пользовательские объекты могут настраивать своё логическое значение, предоставив метод [`__bool__()`](https://python-all.ru/3/reference/datamodel.html#object.__bool__).10681069Оператор [`not`](https://python-all.ru/3/reference/expressions.html#not) возвращает `True`, если его аргумент ложен, и `False` в противном случае.10701071Выражение `x and y` сначала вычисляет *x*; если *x* ложно, возвращается его значение; в противном случае вычисляется *y* и возвращается полученное значение.10721073Выражение `x or y` сначала вычисляет *x*; если *x* истинно, возвращается его значение; в противном случае вычисляется *y* и возвращается полученное значение.10741075Обратите внимание, что ни [`and`](https://python-all.ru/3/reference/expressions.html#and), ни [`or`](https://python-all.ru/3/reference/expressions.html#or) не ограничивают возвращаемое значение и тип до `False` и `True`, а возвращают последний вычисленный аргумент. Это иногда бывает полезно, например, если `s` – строка, которую нужно заменить значением по умолчанию, если она пуста, выражение `s or 'foo'` даёт нужное значение. Поскольку [`not`](https://python-all.ru/3/reference/expressions.html#not) должен создать новое значение, он возвращает логическое значение независимо от типа своего аргумента (например, `not 'foo'` даёт `False`, а не `''`).10761077## 6.12. Выражения присваивания10781079```10801081assignment_expression: [identifier ":="] expression1082```10831084Выражение присваивания (иногда также называемое «именованным выражением» или «моржом») присваивает [`expression`](https://python-all.ru/3/reference/expressions.html#grammar-token-python-grammar-expression) [`identifier`](https://python-all.ru/3/reference/lexical_analysis.html#grammar-token-python-grammar-identifier), одновременно возвращая значение `expression`.10851086Один из распространённых случаев использования – при обработке совпавших регулярных выражений:10871088```python1089if matching := pattern.search(data):1090 do_something(matching)1091```10921093Или при обработке файлового потока по частям:10941095```python1096while chunk := file.read(9000):1097 process(chunk)1098```10991100Выражения присваивания должны быть заключены в круглые скобки, если они используются как выражения-инструкции, а также как подвыражения в срезах, условных выражениях, лямбда-выражениях, выражениях с именованными аргументами и в условиях генераторов списков, а также в инструкциях `assert`, `with` и `assignment`. Во всех остальных местах, где они допустимы, скобки не требуются, в том числе в инструкциях `if` и `while`.11011102Добавлено в версии 3.8: См. [**PEP 572**](https://python-all.ru/3/reference/expressions.html) для получения дополнительных сведений о выражениях присваивания.11031104## 6.13. Условные выражения11051106```11071108conditional_expression: or_test ["if" or_test "else" expression]1109expression: conditional_expression | lambda_expr1110```11111112Условное выражение (иногда называемое «тернарным оператором») является альтернативой инструкции if-else. Поскольку это выражение, оно возвращает значение и может использоваться как подвыражение.11131114Выражение `x if C else y` сначала вычисляет условие *C*, а не *x*. Если *C* истинно, вычисляется *x* и возвращается его значение; в противном случае вычисляется *y* и возвращается его значение.11151116См. [**PEP 308**](https://python-all.ru/3/reference/expressions.html) для получения дополнительных сведений об условных выражениях.11171118## 6.14. Лямбда-выражения11191120```11211122lambda_expr: "lambda" [parameter_list] ":" expression1123```11241125Лямбда-выражения (иногда называемые лямбда-формами) используются для создания анонимных функций. Выражение `lambda parameters: expression` возвращает объект функции. Этот безымянный объект ведёт себя как объект функции, определённый с помощью:11261127```text1128def <lambda>(parameters):1129 return expression1130```11311132См. раздел [Определения функций](https://python-all.ru/3/reference/compound_stmts.html#function) о синтаксисе списков параметров. Обратите внимание, что функции, созданные с помощью лямбда-выражений, не могут содержать инструкции или аннотации.11331134## 6.15. Списки выражений11351136```11371138starred_expression: "*" or_expr | expression1139flexible_expression: assignment_expression | starred_expression1140flexible_expression_list: flexible_expression ("," flexible_expression)* [","]1141starred_expression_list: starred_expression ("," starred_expression)* [","]1142expression_list: expression ("," expression)* [","]1143yield_list: expression_list | starred_expression "," [starred_expression_list]1144```11451146За исключением случаев, когда список выражений является частью литерала списка или множества, список выражений, содержащий хотя бы одну запятую, образует кортеж. Длина кортежа равна количеству выражений в списке. Выражения вычисляются слева направо.11471148Звёздочка `*` обозначает *распаковку итерируемого объекта*. Её операндом должен быть [итерируемый объект](https://python-all.ru/3/glossary.html#term-iterable). Итерируемый объект раскрывается в последовательность элементов, которые включаются в новый кортеж, список или множество в месте распаковки.11491150Добавлено в версии 3.5: Распаковка итерируемых объектов в списках выражений, изначально предложенная в [**PEP 448**](https://python-all.ru/3/reference/expressions.html).11511152Добавлено в версии 3.11: Любой элемент в списке выражений может быть помечен звёздочкой. См. [**PEP 646**](https://python-all.ru/3/reference/expressions.html).11531154Завершающая запятая требуется только для создания кортежа из одного элемента, например `1,`; во всех остальных случаях она необязательна. Одиночное выражение без завершающей запятой не создаёт кортеж, а возвращает значение этого выражения. (Чтобы создать пустой кортеж, используйте пустую пару круглых скобок: `()`.)11551156## 6.16. Порядок вычисления11571158Python вычисляет выражения слева направо. Обратите внимание, что при вычислении присваивания сначала вычисляется правая часть, а затем левая.11591160В следующих строках выражения будут вычисляться в арифметическом порядке их суффиксов:11611162```python1163expr1, expr2, expr3, expr41164(expr1, expr2, expr3, expr4)1165{expr1: expr2, expr3: expr4}1166expr1 + expr2 * (expr3 - expr4)1167expr1(expr2, expr3, *expr4, **expr5)1168expr3, expr4 = expr1, expr21169```11701171## 6.17. Приоритет операторов11721173В следующей таблице представлен приоритет операторов в Python, от наивысшего приоритета (самая сильная связь) до наименьшего (самая слабая связь). Операторы в одной ячейке имеют одинаковый приоритет. Если синтаксис не указан явно, операторы являются бинарными. Операторы в одной ячейке группируются слева направо (за исключением возведения в степень и условных выражений, которые группируются справа налево).11741175Сравнения, проверки принадлежности и проверки тождественности имеют одинаковый приоритет и связываются слева направо, как описано в разделе [Сравнения](https://python-all.ru/3/reference/expressions.html#comparisons).11761177| Оператор | Описание |1178| --- | --- |1179| `(expressions...)`, `[expressions...]`, `{key: value...}`, `{expressions...}` | Связывание или выражение в скобках, список, словарь, множество |1180| `x[index]`, `x[index:index]` `x(arguments...)`, `x.attribute` | Индексация (включая срезы), вызов, ссылка на атрибут |1181| [`await x`](https://python-all.ru/3/reference/expressions.html#await) | Выражение await |1182| `**` | Возведение в степень [\[5\]](https://python-all.ru/3/reference/expressions.html#id22) |1183| `+x`, `-x`, `~x` | Унарный плюс, унарный минус, побитовое НЕ |1184| `*`, `@`, `/`, `//`, `%` | Умножение, матричное умножение, деление, целочисленное деление, остаток [\[6\]](https://python-all.ru/3/reference/expressions.html#id23) |1185| `+`, `-` | Сложение и вычитание |1186| `<<`, `>>` | Сдвиги |1187| `&` | Побитовое И |1188| `^` | Побитовое исключающее ИЛИ |1189| `\|` | Побитовое ИЛИ |1190| [`in`](https://python-all.ru/3/reference/expressions.html#in), [`not in`](https://python-all.ru/3/reference/expressions.html#not-in), [`is`](https://python-all.ru/3/reference/expressions.html#is), [`is not`](https://python-all.ru/3/reference/expressions.html#is-not), `<`, `<=`, `>`, `>=`, `!=`, `==` | Сравнения, включая проверки принадлежности и тождественности |1191| [`not x`](https://python-all.ru/3/reference/expressions.html#not) | Логическое НЕ |1192| [`and`](https://python-all.ru/3/reference/expressions.html#and) | Логическое И |1193| [`or`](https://python-all.ru/3/reference/expressions.html#or) | Логическое ИЛИ |1194| [`if`](https://python-all.ru/3/reference/expressions.html#if-expr) – `else` | Условное выражение |1195| [`lambda`](https://python-all.ru/3/reference/expressions.html#lambda) | Лямбда-выражение |1196| `:=` | Выражение присваивания |11971198Сноски11991200\[[1](https://python-all.ru/3/reference/expressions.html#id9)\]12011202Хотя математически `abs(x%y) < abs(y)` истинно, для чисел с плавающей запятой оно может не выполняться численно из-за округления. Например, если предположить платформу, на которой число с плавающей запятой Python является числом двойной точности IEEE 754, то чтобы `-1e-100 % 1e100` имело тот же знак, что и `1e100`, вычисленный результат равен `-1e-100 + 1e100`, что численно в точности равно `1e100`. Функция [`math.fmod()`](https://python-all.ru/3/library/math.html#math.fmod) вместо этого возвращает результат, знак которого совпадает со знаком первого аргумента, поэтому в данном случае возвращает `-1e-100`. Какой подход более уместен, зависит от приложения.12031204\[[2](https://python-all.ru/3/reference/expressions.html#id10)\]12051206Если x очень близок к целому кратному y, возможно, что `x//y` будет на единицу больше `(x-x%y)//y` из-за округления. В таких случаях Python возвращает последний результат, чтобы `divmod(x,y)[0] * y + x % y` оставался очень близким к `x`.12071208\[[3](https://python-all.ru/3/reference/expressions.html#id12)\]12091210Стандарт Unicode различает *кодовые точки* (например, U+0041) и *абстрактные символы* (например, «LATIN CAPITAL LETTER A»). Хотя большинство абстрактных символов в Unicode представлены одной кодовой точкой, существует ряд абстрактных символов, которые могут быть представлены последовательностью из нескольких кодовых точек. Например, абстрактный символ «LATIN CAPITAL LETTER C WITH CEDILLA» может быть представлен как один *предварительно составленный символ* в позиции U+00C7 или как последовательность *базового символа* в позиции U+0043 (LATIN CAPITAL LETTER C), за которым следует *комбинируемый символ* в позиции U+0327 (COMBINING CEDILLA).12111212Операторы сравнения строк сравнивают на уровне кодовых точек Unicode. Это может быть неинтуитивно для человека. Например, `"\u00C7" == "\u0043\u0327"` равно `False`, хотя обе строки представляют один и тот же абстрактный символ «LATIN CAPITAL LETTER C WITH CEDILLA».12131214Для сравнения строк на уровне абстрактных символов (то есть интуитивно понятным способом) используется [`unicodedata.normalize()`](https://python-all.ru/3/library/unicodedata.html#unicodedata.normalize).12151216\[[4](https://python-all.ru/3/reference/expressions.html#id13)\]12171218Из-за автоматической сборки мусора, списков свободных объектов и динамической природы дескрипторов может наблюдаться, казалось бы, необычное поведение при определённых использованиях оператора [`is`](https://python-all.ru/3/reference/expressions.html#is), например, при сравнениях между методами экземпляров или константами. За дополнительной информацией обратитесь к их документации.12191220\[[5](https://python-all.ru/3/reference/expressions.html#id16)\]12211222Оператор возведения в степень `**` связывает менее тесно, чем арифметический или побитовый унарный оператор справа от него, то есть `2**-1` равно `0.5`.12231224\[[6](https://python-all.ru/3/reference/expressions.html#id17)\]12251226Оператор `%` также используется для форматирования строк; для него действует тот же приоритет.1227