expressions.md
1> **Источник:** https://python-all.ru/3.5/reference/expressions.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 6. Выражения89В этой главе объясняется значение элементов выражений в Python.1011**Примечания к синтаксису:** В этой и следующих главах для описания синтаксиса, а не лексического анализа, будет использоваться расширенная нотация БНФ. Когда (одна из альтернатив) синтаксического правила имеет вид1213```1415name ::= othername16```1718и семантика не указана, то семантика этой формы `name` такая же, как для `othername`.1920## 6.1. Арифметические преобразования2122Когда в описании арифметического оператора ниже используется фраза «числовые аргументы преобразуются к общему типу», это означает, что реализация оператора для встроенных типов работает следующим образом:2324- Если хотя бы один аргумент – комплексное число, другой преобразуется в комплексное;25- в противном случае, если хотя бы один аргумент является числом с плавающей запятой, другой преобразуется в число с плавающей запятой;26- в противном случае оба должны быть целыми числами, и преобразование не требуется.2728Для некоторых операторов применяются дополнительные правила (например, строка в качестве левого аргумента оператора «%»). Расширения должны определять собственное поведение преобразования.2930## 6.2. Атомы3132Атомы – это самые базовые элементы выражений. Простейшие атомы – идентификаторы или литералы. Формы, заключённые в круглые, квадратные или фигурные скобки, также синтаксически относятся к атомам. Синтаксис атомов:3334```3536atom ::= identifier | literal | enclosure37enclosure ::= parenth_form | list_display | dict_display | set_display38 | generator_expression | yield_atom39```4041### 6.2.1. Идентификаторы (имена)4243Идентификатор, выступающий в роли атома, является именем. См. раздел [Идентификаторы и ключевые слова](https://python-all.ru/3.5/reference/lexical_analysis.html#identifiers) для лексического определения и раздел [Именование и связывание](https://python-all.ru/3.5/reference/executionmodel.html#naming) для документации по именованию и связыванию.4445Когда имя привязано к объекту, вычисление атома возвращает этот объект. Когда имя не привязано, попытка его вычисления вызывает [`NameError`](https://python-all.ru/3.5/library/exceptions.html#NameError) исключение.4647**Искажение имени приватного атрибута:** Когда идентификатор, текстуально встречающийся в определении класса, начинается с двух или более символов подчёркивания и не заканчивается двумя или более подчёркиваниями, он считается *приватным именем* этого класса. Приватные имена преобразуются в более длинную форму перед генерацией кода для них. Преобразование вставляет имя класса, с удалёнными ведущими подчёркиваниями и одним вставленным подчёркиванием, перед именем. Например, идентификатор `__spam`, встречающийся в классе с именем `Ham`, будет преобразован в `_Ham__spam`. Это преобразование не зависит от синтаксического контекста, в котором используется идентификатор. Если преобразованное имя слишком длинное (длиннее 255 символов), может произойти усечение, определяемое реализацией. Если имя класса состоит только из подчёркиваний, преобразование не выполняется.4849### 6.2.2. Литералы5051Python поддерживает строковые литералы, литералы bytes и различные числовые литералы:5253```5455literal ::= stringliteral | bytesliteral56 | integer | floatnumber | imagnumber57```5859Вычисление литерала даёт объект указанного типа (строка, bytes, целое число, число с плавающей запятой, комплексное число) с указанным значением. Значение может быть приближённым для литералов с плавающей запятой и мнимых (комплексных). Подробнее см. раздел [Литералы](https://python-all.ru/3.5/reference/lexical_analysis.html#literals).6061Все литералы соответствуют неизменяемым типам данных, поэтому тождественность объекта менее важна, чем его значение. При многократном вычислении литералов с одинаковым значением (одного и того же или разных вхождений в тексте программы) может получаться как один и тот же объект, так и разные объекты с одним и тем же значением.6263### 6.2.3. Формы в скобках6465Выражение в скобках – это необязательный список выражений, заключённый в круглые скобки:6667```6869parenth_form ::= "(" [starred_expression] ")"70```7172Вычисление списка выражений в скобках даёт результат этого списка: если список содержит хотя бы одну запятую, получается кортеж; в противном случае – единственное выражение, из которого состоит список.7374Пустая пара круглых скобок создаёт пустой объект кортежа. Поскольку кортежи неизменяемы, применяются правила для литералов (т.е. два вхождения пустого кортежа могут давать один и тот же объект или нет).7576Обратите внимание, что кортежи образуются не круглыми скобками, а использованием оператора запятой. Исключением является пустой кортеж, для которого круглые скобки *требуются* – разрешение «ничего» без скобок в выражениях привело бы к неоднозначностям и позволило бы распространённым опечаткам остаться незамеченными.7778### 6.2.4. Отображения списков, множеств и словарей7980Для создания списка, множества или словаря в Python предусмотрен специальный синтаксис, называемый «отображениями» (displays); каждый из них существует в двух вариантах:8182- либо содержимое контейнера перечисляется явно, либо83- они вычисляются с помощью набора инструкций циклов и фильтрации, называемого *включением (comprehension)*.8485Общие синтаксические элементы для включений:8687```8889comprehension ::= expression comp_for90comp_for ::= "for" target_list "in" or_test [comp_iter]91comp_iter ::= comp_for | comp_if92comp_if ::= "if" expression_nocond [comp_iter]93```9495Включение состоит из одного выражения, за которым следует по крайней мере одно предложение [`for`](https://python-all.ru/3.5/reference/compound_stmts.html#for) и ноль или более предложений [`for`](https://python-all.ru/3.5/reference/compound_stmts.html#for) или [`if`](https://python-all.ru/3.5/reference/compound_stmts.html#if). В этом случае элементами нового контейнера будут те, которые получаются при рассмотрении каждого из предложений [`for`](https://python-all.ru/3.5/reference/compound_stmts.html#for) или [`if`](https://python-all.ru/3.5/reference/compound_stmts.html#if) как блока, с вложением слева направо, и вычислении выражения для получения элемента каждый раз, когда достигается самый внутренний блок.9697Обратите внимание, что включение выполняется в отдельной области видимости, поэтому имена, присвоенные в списке целей, не «просачиваются» в окружающую область видимости.9899### 6.2.5. Отображения списков100101Списковое отображение – это возможно пустая последовательность выражений, заключённая в квадратные скобки:102103```104105list_display ::= "[" [starred_list | comprehension] "]"106```107108Списковое отображение возвращает новый объект списка, содержимое которого задаётся либо списком выражений, либо включением. Если предоставлен разделённый запятыми список выражений, его элементы вычисляются слева направо и помещаются в объект списка в том же порядке. Если предоставлено включение, список строится из элементов, полученных в результате включения.109110### 6.2.6. Отображения множеств111112Множественное отображение обозначается фигурными скобками и отличается от словарных отображений отсутствием двоеточий, разделяющих ключи и значения:113114```115116set_display ::= "{" (starred_list | comprehension) "}"117```118119Множественное отображение возвращает новый изменяемый объект множества, содержимое которого задаётся либо последовательностью выражений, либо включением. Если предоставлен разделённый запятыми список выражений, его элементы вычисляются слева направо и добавляются в объект множества. Если предоставлено включение, множество строится из элементов, полученных в результате включения.120121Пустое множество нельзя создать с помощью `{}`; этот литерал создаёт пустой словарь.122123### 6.2.7. Отображения словарей124125Отображение словаря – это возможно пустая последовательность пар ключ/значение, заключённая в фигурные скобки:126127```128129dict_display ::= "{" [key_datum_list | dict_comprehension] "}"130key_datum_list ::= key_datum ("," key_datum)* [","]131key_datum ::= expression ":" expression | "**" or_expr132dict_comprehension ::= expression ":" expression comp_for133```134135Словарное отображение возвращает новый объект словаря.136137Если задана разделённая запятыми последовательность пар ключ/значение, они вычисляются слева направо для определения записей словаря: каждый объект ключа используется как ключ в словаре для хранения соответствующего значения. Это означает, что можно указать один и тот же ключ несколько раз в списке ключ/значение, и итоговое значение словаря для этого ключа будет последним указанным.138139Двойная звёздочка `**` обозначает *распаковку словаря*. Её операндом должно быть [отображение](https://python-all.ru/3.5/glossary.html#term-mapping). Каждый элемент отображения добавляется в новый словарь. Более поздние значения заменяют значения, уже установленные более ранними парами ключ/значение и более ранними распаковками словарей.140141Новое в версии 3.5: Распаковка в отображения словарей, изначально предложенная в [**PEP 448**](https://python-all.ru/3.5/reference/expressions.html).142143Словарное включение, в отличие от списковых и множественных включений, требует двух выражений, разделённых двоеточием, после которых следуют обычные предложения «for» и «if». При выполнении включения результирующие элементы ключей и значений вставляются в новый словарь в порядке их получения.144145Ограничения на типы ключей перечислены ранее в разделе [Стандартная иерархия типов](https://python-all.ru/3.5/reference/datamodel.html#types). (Кратко: тип ключа должен быть [хешируемым](https://python-all.ru/3.5/glossary.html#term-hashable), что исключает все изменяемые объекты.) Конфликты между дублирующимися ключами не обнаруживаются; последнее значение (текстуально самое правое в отображении), сохранённое для данного ключа, побеждает.146147### 6.2.8. Генераторные выражения148149Генераторное выражение – это компактная запись генератора в круглых скобках:150151```152153generator_expression ::= "(" expression comp_for ")"154```155156Генераторное выражение возвращает новый объект-генератор. Его синтаксис такой же, как у включений, за исключением того, что оно заключается в круглые скобки вместо квадратных или фигурных.157158Переменные, используемые в генераторном выражении, вычисляются лениво при вызове метода [`__next__()`](https://python-all.ru/3.5/reference/expressions.html#generator.__next__) для объекта-генератора (так же, как и в обычных генераторах). Однако крайняя слева [`for`](https://python-all.ru/3.5/reference/compound_stmts.html#for)-клауза вычисляется немедленно, поэтому ошибка, вызванная ею, может быть замечена раньше любых других возможных ошибок в коде, обрабатывающем генераторное выражение. Последующие [`for`](https://python-all.ru/3.5/reference/compound_stmts.html#for)-клаузы не могут быть вычислены немедленно, так как они могут зависеть от предыдущего [`for`](https://python-all.ru/3.5/reference/compound_stmts.html#for)-цикла. Например: `(x*y for x in range(10) for y in bar(x))`.159160Круглые скобки можно опускать при вызовах с одним аргументом. Подробнее см. раздел [Вызовы](https://python-all.ru/3.5/reference/expressions.html#calls).161162### 6.2.9. Выражения yield163164```165166yield_atom ::= "(" yield_expression ")"167yield_expression ::= "yield" [expression_list | "from" expression]168```169170Выражение yield используется только при определении [функции-генератора](https://python-all.ru/3.5/glossary.html#term-generator) и, следовательно, может использоваться только в теле определения функции. Использование yield выражения в теле функции превращает эту функцию в генератор.171172Когда вызывается генераторная функция, она возвращает итератор, называемый генератором. Затем этот генератор управляет выполнением генераторной функции. Выполнение начинается, когда вызывается один из методов генератора. В этот момент выполнение переходит к первому выражению yield, где оно снова приостанавливается, возвращая значение [`expression_list`](https://python-all.ru/3.5/reference/expressions.html#grammar-token-expression-list) вызывающей стороне генератора. Под приостановкой подразумевается, что сохраняется всё локальное состояние, включая текущие привязки локальных переменных, указатель инструкции, внутренний стек вычислений и состояние обработки исключений. Когда выполнение возобновляется вызовом одного из методов генератора, функция может продолжить работу так, как если бы выражение yield было просто очередным внешним вызовом. Значение выражения yield после возобновления зависит от метода, который возобновил выполнение. Если используется [`__next__()`](https://python-all.ru/3.5/reference/expressions.html#generator.__next__) (обычно через [`for`](https://python-all.ru/3.5/reference/compound_stmts.html#for) или встроенную функцию [`next()`](https://python-all.ru/3.5/library/functions.html#next)), то результатом будет [`None`](https://python-all.ru/3.5/library/constants.html#None). В противном случае, если используется [`send()`](https://python-all.ru/3.5/reference/expressions.html#generator.send), результатом будет значение, переданное этому методу.173174Всё это делает функции-генераторы весьма похожими на корутины; они могут выдавать значения несколько раз, имеют более одной точки входа, и их выполнение может быть приостановлено. Единственное отличие в том, что функция-генератор не может управлять тем, где должно продолжиться выполнение после yield; управление всегда передаётся вызывающему generator.175176Выражения yield разрешены в любом месте конструкции [`try`](https://python-all.ru/3.5/reference/compound_stmts.html#try). Если generator не возобновляется до его завершения (достижение нулевого счётчика ссылок или сборка мусора), будет вызван метод [`close()`](https://python-all.ru/3.5/reference/expressions.html#generator.close) generator-итератора, что позволит выполнить все ожидающие предложения [`finally`](https://python-all.ru/3.5/reference/compound_stmts.html#finally).177178Когда используется `yield from <expr>`, он обрабатывает предоставленное выражение как субитератор. Все значения, полученные от этого субитератора, передаются напрямую вызывающему методы текущего генератора. Любые значения, переданные с помощью [`send()`](https://python-all.ru/3.5/reference/expressions.html#generator.send), и любые исключения, переданные с помощью [`throw()`](https://python-all.ru/3.5/reference/expressions.html#generator.throw), передаются нижележащему итератору, если он имеет соответствующие методы. Если это не так, то [`send()`](https://python-all.ru/3.5/reference/expressions.html#generator.send) вызовет [`AttributeError`](https://python-all.ru/3.5/library/exceptions.html#AttributeError) или [`TypeError`](https://python-all.ru/3.5/library/exceptions.html#TypeError), а [`throw()`](https://python-all.ru/3.5/reference/expressions.html#generator.throw) просто сразу вызовет переданное исключение.179180Когда нижележащий итератор завершается, атрибут `value` возбуждённого экземпляра [`StopIteration`](https://python-all.ru/3.5/library/exceptions.html#StopIteration) становится значением выражения yield. Он может быть задан явно при возбуждении [`StopIteration`](https://python-all.ru/3.5/library/exceptions.html#StopIteration), либо автоматически, когда под-итератор является генератором (путём возврата значения из под-генератора).181182> Изменено в версии 3.3: Добавлено `yield from <expr>` для делегирования потока управления под-итератору.183184Круглые скобки могут быть опущены, когда выражение yield является единственным выражением в правой части оператора присваивания.185186> **См. также**187>188> **[**PEP 255**](https://python-all.ru/3.5/reference/expressions.html) - Simple Generators**189>190> Предложение по добавлению генераторов и оператора191>192> [`yield`](https://python-all.ru/3.5/reference/simple_stmts.html#yield)193>194> в Python.195>196> **[**PEP 342**](https://python-all.ru/3.5/reference/expressions.html) - Coroutines via Enhanced Generators**197>198> Предложение по улучшению API и синтаксиса генераторов, позволяющее использовать их как простые корутины.199>200> **[**PEP 380**](https://python-all.ru/3.5/reference/expressions.html) - Syntax for Delegating to a Subgenerator**201>202> Предложение ввести синтаксис203>204> `yield_from`205>206> , упрощающий делегирование под-генераторам.207208#### 6.2.9.1. Методы итератора генератора209210В этом подразделе описаны методы итератора генератора. Они могут использоваться для управления выполнением генераторной функции.211212Обратите внимание, что вызов любого из приведённых ниже методов генератора, когда генератор уже выполняется, приводит к исключению [`ValueError`](https://python-all.ru/3.5/library/exceptions.html#ValueError).213214#### `generator.__next__()`215216Запускает выполнение генераторной функции или возобновляет его на последнем выполненном выражении yield. Когда генераторная функция возобновляется методом [`__next__()`](https://python-all.ru/3.5/reference/expressions.html#generator.__next__), текущее выражение yield всегда вычисляется в [`None`](https://python-all.ru/3.5/library/constants.html#None). Затем выполнение переходит к следующему выражению yield, где генератор снова приостанавливается, и значение [`expression_list`](https://python-all.ru/3.5/reference/expressions.html#grammar-token-expression-list) возвращается вызывающей стороне [`__next__()`](https://python-all.ru/3.5/reference/expressions.html#generator.__next__). Если генератор завершается, не вернув другого значения, возбуждается исключение [`StopIteration`](https://python-all.ru/3.5/library/exceptions.html#StopIteration).217218Обычно этот метод вызывается неявно, например, циклом [`for`](https://python-all.ru/3.5/reference/compound_stmts.html#for) или встроенной функцией [`next()`](https://python-all.ru/3.5/library/functions.html#next).219220#### `generator.send(value)`221222Возобновляет выполнение и «отправляет» значение в генераторную функцию. Аргумент *value* становится результатом текущего выражения yield. Метод [`send()`](https://python-all.ru/3.5/reference/expressions.html#generator.send) возвращает следующее значение, выданное генератором, или возбуждает [`StopIteration`](https://python-all.ru/3.5/library/exceptions.html#StopIteration), если генератор завершается, не выдав другого значения. При вызове [`send()`](https://python-all.ru/3.5/reference/expressions.html#generator.send) для запуска генератора его необходимо вызывать с аргументом [`None`](https://python-all.ru/3.5/library/constants.html#None), так как нет выражения yield, которое могло бы получить значение.223224#### `generator.throw(type[, value[, traceback]])`225226Вызывает исключение типа `type` в точке, где генератор был приостановлен, и возвращает следующее значение, выданное функцией-генератором. Если генератор завершается, не выдав другого значения, возбуждается исключение [`StopIteration`](https://python-all.ru/3.5/library/exceptions.html#StopIteration). Если функция-генератор не перехватывает переданное исключение или возбуждает другое исключение, то это исключение передаётся вызывающему коду.227228#### `generator.close()`229230Возбуждает [`GeneratorExit`](https://python-all.ru/3.5/library/exceptions.html#GeneratorExit) в точке, где была приостановлена функция-генератор. Если после этого функция-генератор завершается штатно, уже закрыта или возбуждает [`GeneratorExit`](https://python-all.ru/3.5/library/exceptions.html#GeneratorExit) (не перехватывая исключение), close возвращается к вызвавшему коду. Если генератор выдает значение, возбуждается [`RuntimeError`](https://python-all.ru/3.5/library/exceptions.html#RuntimeError). Если генератор возбуждает любое другое исключение, оно передается вызвавшему коду. [`close()`](https://python-all.ru/3.5/reference/expressions.html#generator.close) ничего не делает, если генератор уже завершился из-за исключения или штатно.231232#### 6.2.9.2. Примеры233234Вот простой пример, демонстрирующий поведение генераторов и генераторных функций:235236```python237>>> def echo(value=None):238... print("Execution starts when 'next()' is called for the first time.")239... try:240... while True:241... try:242... value = (yield value)243... except Exception as e:244... value = e245... finally:246... print("Don't forget to clean up when 'close()' is called.")247...248>>> generator = echo(1)249>>> print(next(generator))250Execution starts when 'next()' is called for the first time.2511252>>> print(next(generator))253None254>>> print(generator.send(2))2552256>>> generator.throw(TypeError, "spam")257TypeError('spam',)258>>> generator.close()259Don't forget to clean up when 'close()' is called.260```261262Примеры использования `yield from` см. в [PEP 380: Syntax for Delegating to a Subgenerator](https://python-all.ru/3.5/whatsnew/3.3.html#pep-380) в разделе «What’s New in Python».263264## 6.3. Первичные выражения265266Первичные выражения представляют операции с самой высокой связностью в языке. Их синтаксис:267268```269270primary ::= atom | attributeref | subscription | slicing | call271```272273### 6.3.1. Ссылки на атрибуты274275Ссылка на атрибут – это первичное выражение, за которым следуют точка и имя:276277```278279attributeref ::= primary "." identifier280```281282Первичное выражение должно вычисляться в объект типа, который поддерживает ссылки на атрибуты (большинство объектов это делают). Затем у этого объекта запрашивается атрибут, имя которого является идентификатором. Это получение можно настроить, переопределив метод [`__getattr__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__getattr__). Если такой атрибут недоступен, возбуждается исключение [`AttributeError`](https://python-all.ru/3.5/library/exceptions.html#AttributeError). В противном случае тип и значение полученного объекта определяются объектом. Многократные вычисления одной и той же ссылки на атрибут могут давать разные объекты.283284### 6.3.2. Подписки285286Индексация выбирает элемент последовательности (строки, кортежа или списка) или отображения (словаря):287288```289290subscription ::= primary "[" expression_list "]"291```292293Первичное выражение должно вычисляться в объект, поддерживающий индексацию (например, списки или словари). Пользовательские объекты могут поддерживать индексацию, определив метод [`__getitem__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__getitem__).294295Для встроенных объектов существует два типа объектов, поддерживающих индексацию:296297Если первичное выражение является отображением, список выражений должен вычисляться в объект, значение которого является одним из ключей отображения, и индексация выбирает значение в отображении, соответствующее этому ключу. (Список выражений представляет собой кортеж, за исключением случая, когда он содержит ровно один элемент.)298299Если первичное выражение является последовательностью, то выражение (список) должно вычисляться в целое число или срез (как обсуждается в следующем разделе).300301Формальный синтаксис не предусматривает особой обработки отрицательных индексов для последовательностей; однако все встроенные последовательности предоставляют метод [`__getitem__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__getitem__), который интерпретирует отрицательные индексы, прибавляя длину последовательности к индексу (так что `x[-1]` выбирает последний элемент `x`). Полученное значение должно быть неотрицательным целым числом, меньшим количества элементов в последовательности, и индексация выбирает элемент с этим индексом (начиная с нуля). Поскольку поддержка отрицательных индексов и срезов реализована в методе [`__getitem__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__getitem__) объекта, подклассы, переопределяющие этот метод, должны явно добавлять эту поддержку.302303Элементами строки являются символы. Символ не является отдельным типом данных, а представляет собой строку ровно из одного символа.304305### 6.3.3. Срезы306307Срез выбирает диапазон элементов в объекте-последовательности (например, строке, кортеже или списке). Срезы могут использоваться как выражения или как цели в операторах присваивания или [`del`](https://python-all.ru/3.5/reference/simple_stmts.html#del). Синтаксис среза:308309```310311slicing ::= primary "[" slice_list "]"312slice_list ::= slice_item ("," slice_item)* [","]313slice_item ::= expression | proper_slice314proper_slice ::= [lower_bound] ":" [upper_bound] [ ":" [stride] ]315lower_bound ::= expression316upper_bound ::= expression317stride ::= expression318```319320В формальном синтаксисе здесь есть неоднозначность: всё, что выглядит как список выражений, также выглядит как список срезов, поэтому любую индексацию можно интерпретировать как срез. Чтобы не усложнять синтаксис, эта неоднозначность разрешается тем, что в данном случае интерпретация как индексация имеет приоритет над интерпретацией как срез (это верно, если список срезов не содержит полноценного среза).321322Семантика среза следующая. Первичный объект индексируется (с использованием того же метода [`__getitem__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__getitem__), что и для обычной индексации) ключом, который строится из списка срезов следующим образом. Если список срезов содержит хотя бы одну запятую, ключом является кортеж, содержащий преобразованные элементы среза; в противном случае ключом является преобразованный единственный элемент среза. Преобразование элемента среза, являющегося выражением, – это само выражение. Преобразование полноценного среза – это объект среза (см. раздел [Стандартная иерархия типов](https://python-all.ru/3.5/reference/datamodel.html#types)), чьи атрибуты `start`, `stop` и `step` являются значениями выражений, заданных как нижняя граница, верхняя граница и шаг соответственно, с подстановкой `None` для отсутствующих выражений.323324### 6.3.4. Вызовы325326Вызов – это обращение к вызываемому объекту (например, [функции](https://python-all.ru/3.5/glossary.html#term-function)) с возможно пустой последовательностью [аргументов](https://python-all.ru/3.5/glossary.html#term-argument):327328```329330call ::= primary "(" [argument_list [","] | comprehension] ")"331argument_list ::= positional_arguments ["," starred_and_keywords]332 ["," keywords_arguments]333 | starred_and_keywords ["," keywords_arguments]334 | keywords_arguments335positional_arguments ::= ["*"] expression ("," ["*"] expression)*336starred_and_keywords ::= ("*" expression | keyword_item)337 ("," "*" expression | "," keyword_item)*338keywords_arguments ::= (keyword_item | "**" expression)339 ("," keyword_item | "," "**" expression)*340keyword_item ::= identifier "=" expression341```342343После позиционных и именованных аргументов может стоять необязательная завершающая запятая, но на семантику это не влияет.344345Первичное выражение должно принимать значение вызываемого объекта (вызываемыми являются: функции, определённые пользователем, встроенные функции, методы встроенных объектов, объекты классов, методы экземпляров классов и все объекты, имеющие метод [`__call__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__call__)). Все выражения аргументов вычисляются до попытки вызова. За синтаксисом списков формальных [параметров](https://python-all.ru/3.5/glossary.html#term-parameter) обращайтесь к разделу [Определения функций](https://python-all.ru/3.5/reference/compound_stmts.html#function).346347Если присутствуют именованные аргументы, они сначала преобразуются в позиционные следующим образом. Сначала создаётся список незаполненных слотов для формальных параметров. Если есть N позиционных аргументов, они помещаются в первые N слотов. Затем для каждого именованного аргумента идентификатор используется для определения соответствующего слота (если идентификатор совпадает с именем первого формального параметра, используется первый слот, и т.д.). Если слот уже заполнен, возбуждается исключение [`TypeError`](https://python-all.ru/3.5/library/exceptions.html#TypeError). В противном случае значение аргумента помещается в слот, заполняя его (даже если выражение равно `None`, оно всё равно заполняет слот). Когда все аргументы обработаны, слоты, которые всё ещё не заполнены, заполняются соответствующим значением по умолчанию из определения функции. (Значения по умолчанию вычисляются один раз при определении функции; таким образом, изменяемый объект, такой как список или словарь, используемый в качестве значения по умолчанию, будет разделяться между всеми вызовами, которые не указывают значение аргумента для соответствующего слота; этого обычно следует избегать.) Если есть незаполненные слоты, для которых не указано значение по умолчанию, возбуждается исключение [`TypeError`](https://python-all.ru/3.5/library/exceptions.html#TypeError). В противном случае список заполненных слотов используется как список аргументов для вызова.348349**Особенность реализации CPython:** Реализация может предоставлять встроенные функции, чьи позиционные параметры не имеют имён, даже если они «названы» для целей документации, и поэтому их нельзя передать по ключевому слову. В CPython это относится к функциям, реализованным на C, которые используют [`PyArg_ParseTuple()`](https://python-all.ru/3.5/c-api/arg.html#c.PyArg_ParseTuple) для разбора своих аргументов.350351Если позиционных аргументов больше, чем слотов формальных параметров, возбуждается исключение [`TypeError`](https://python-all.ru/3.5/library/exceptions.html#TypeError), если только не присутствует формальный параметр с синтаксисом `*identifier`; в этом случае этот формальный параметр получает кортеж, содержащий лишние позиционные аргументы (или пустой кортеж, если лишних позиционных аргументов не было).352353Если какой-либо именованный аргумент не соответствует имени формального параметра, возбуждается исключение [`TypeError`](https://python-all.ru/3.5/library/exceptions.html#TypeError), если только не присутствует формальный параметр с синтаксисом `**identifier`; в этом случае этот формальный параметр получает словарь, содержащий лишние именованные аргументы (с ключами в качестве имён и значениями аргументов в качестве соответствующих значений), или (новый) пустой словарь, если лишних именованных аргументов не было.354355Если в вызове функции присутствует синтаксис `*expression`, `expression` должен принимать значение [итерируемого объекта](https://python-all.ru/3.5/glossary.html#term-iterable). Элементы из этих итерируемых объектов рассматриваются как дополнительные позиционные аргументы. Для вызова `f(x1, x2, *y, x3, x4)`, если *y* принимает значение последовательности *y1*, …, *yM*, это эквивалентно вызову с M+4 позиционными аргументами *x1*, *x2*, *y1*, …, *yM*, *x3*, *x4*.356357Следствием этого является то, что хотя синтаксис `*expression` может появляться *после* явных именованных аргументов, он обрабатывается *до* именованных аргументов (и любых аргументов `**expression` – см. ниже). Итак:358359```python360>>> def f(a, b):361... print(a, b)362...363>>> f(b=1, *(2,))3642 1365>>> f(a=1, *(2,))366Traceback (most recent call last):367 File "<stdin>", line 1, in <module>368TypeError: f() got multiple values for keyword argument 'a'369>>> f(1, *(2,))3701 2371```372373Использование одновременно именованных аргументов и синтаксиса `*expression` в одном вызове необычно, поэтому на практике такая путаница не возникает.374375Если в вызове функции присутствует синтаксис `**expression`, `expression` должно вычисляться в [отображение](https://python-all.ru/3.5/glossary.html#term-mapping), содержимое которого обрабатывается как дополнительные именованные аргументы. Если ключевое слово уже присутствует (как явный именованный аргумент или из другой распаковки), возбуждается исключение [`TypeError`](https://python-all.ru/3.5/library/exceptions.html#TypeError).376377Формальные параметры с синтаксисом `*identifier` или `**identifier` не могут использоваться как слоты позиционных аргументов или как имена именованных аргументов.378379Изменено в версии 3.5: Вызовы функций принимают любое количество распаковок `*` и `**`, позиционные аргументы могут следовать за распаковками итерируемых объектов (`*`), а именованные аргументы – за распаковками словарей (`**`). Изначально предложено в [**PEP 448**](https://python-all.ru/3.5/reference/expressions.html).380381Вызов всегда возвращает некоторое значение, возможно `None`, если только не возбуждается исключение. Как вычисляется это значение, зависит от типа вызываемого объекта.382383Если это–384385**пользовательская функция:**386387Блок кода функции выполняется, ему передаётся список аргументов. Первое, что делает блок кода, – связывает формальные параметры с аргументами; это описано в разделе [Определения функций](https://python-all.ru/3.5/reference/compound_stmts.html#function). Когда блок кода выполняет инструкцию [`return`](https://python-all.ru/3.5/reference/simple_stmts.html#return), она задаёт возвращаемое значение вызова функции.388389**встроенная функция или метод:**390391Результат зависит от интерпретатора; описания встроенных функций и методов см. в [Встроенные функции](https://python-all.ru/3.5/library/functions.html#built-in-funcs).392393**объект класса:**394395Возвращается новый экземпляр этого класса.396397**метод экземпляра класса:**398399Вызывается соответствующая пользовательская функция, со списком аргументов, который на один длиннее списка аргументов вызова: экземпляр становится первым аргументом.400401**экземпляр класса:**402403Класс должен определять метод [`__call__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__call__); результат будет таким же, как если бы был вызван этот метод.404405## 6.4. Выражение await406407Приостанавливает выполнение [корутины](https://python-all.ru/3.5/glossary.html#term-coroutine) на [ожидаемом объекте](https://python-all.ru/3.5/glossary.html#term-awaitable). Может использоваться только внутри [корутинной функции](https://python-all.ru/3.5/glossary.html#term-coroutine-function).408409```410411await_expr ::= "await" primary412```413414Новое в версии 3.5.415416## 6.5. Оператор возведения в степень417418Оператор возведения в степень имеет более высокий приоритет, чем унарные операторы слева, и более низкий приоритет, чем унарные операторы справа. Синтаксис:419420```421422power ::= ( await_expr | primary ) ["**" u_expr]423```424425Таким образом, в последовательности операторов возведения в степень и унарных операторов без скобок операторы вычисляются справа налево (это не накладывает ограничений на порядок вычисления операндов): `-1**2` даёт `-1`.426427Оператор возведения в степень имеет ту же семантику, что и встроенная функция [`pow()`](https://python-all.ru/3.5/library/functions.html#pow), вызываемая с двумя аргументами: он возвращает левый аргумент, возведённый в степень правого аргумента. Числовые аргументы сначала преобразуются к общему типу, и результат имеет этот тип.428429Для операндов типа int результат имеет тот же тип, что и операнды, если только второй аргумент не отрицателен; в этом случае все аргументы преобразуются в float и возвращается результат типа float. Например, `10**2` возвращает `100`, но `10**-2` возвращает `0.01`.430431Возведение `0.0` в отрицательную степень приводит к [`ZeroDivisionError`](https://python-all.ru/3.5/library/exceptions.html#ZeroDivisionError). Возведение отрицательного числа в дробную степень даёт [`complex`](https://python-all.ru/3.5/library/functions.html#complex) число. (В более ранних версиях это вызывало [`ValueError`](https://python-all.ru/3.5/library/exceptions.html#ValueError).)432433## 6.6. Унарные арифметические и побитовые операции434435Все унарные арифметические и побитовые операции имеют одинаковый приоритет:436437```438439u_expr ::= power | "-" u_expr | "+" u_expr | "~" u_expr440```441442Унарный оператор `-` (минус) возвращает отрицание своего числового аргумента.443444Унарный оператор `+` (плюс) возвращает свой числовой аргумент без изменений.445446Унарный оператор `~` (инверсия) возвращает побитовое инвертирование своего целочисленного аргумента. Побитовая инверсия `x` определяется как `-(x+1)`. Он применяется только к целым числам.447448Во всех трёх случаях, если аргумент имеет неправильный тип, вызывается исключение [`TypeError`](https://python-all.ru/3.5/library/exceptions.html#TypeError).449450## 6.7. Бинарные арифметические операции451452Бинарные арифметические операции имеют общепринятые уровни приоритета. Обратите внимание, что некоторые из этих операций также применимы к некоторым нечисловым типам. За исключением оператора возведения в степень, существует только два уровня: один для мультипликативных операторов и один для аддитивных операторов:453454```455456m_expr ::= u_expr | m_expr "*" u_expr | m_expr "@" m_expr |457 m_expr "//" u_expr| m_expr "/" u_expr |458 m_expr "%" u_expr459a_expr ::= m_expr | a_expr "+" m_expr | a_expr "-" m_expr460```461462Оператор `*` (умножения) возвращает произведение своих аргументов. Аргументы должны быть либо оба числами, либо один аргумент – целым числом, а другой – последовательностью. В первом случае числа преобразуются к общему типу и затем перемножаются. Во втором случае выполняется повторение последовательности; отрицательный коэффициент повторения даёт пустую последовательность.463464Оператор `@` (at) предназначен для умножения матриц. Ни один встроенный тип Python не реализует этот оператор.465466Новое в версии 3.5.467468Операторы `/` (деления) и `//` (целочисленного деления) возвращают частное своих аргументов. Числовые аргументы сначала преобразуются к общему типу. Деление целых чисел даёт число с плавающей точкой, а целочисленное деление целых чисел даёт целое число; результат соответствует математическому делению с применением функции «floor» к результату. Деление на ноль вызывает исключение [`ZeroDivisionError`](https://python-all.ru/3.5/library/exceptions.html#ZeroDivisionError).469470Оператор `%` (остаток от деления) возвращает остаток от деления первого аргумента на второй. Числовые аргументы сначала преобразуются к общему типу. Нулевой правый аргумент вызывает исключение [`ZeroDivisionError`](https://python-all.ru/3.5/library/exceptions.html#ZeroDivisionError). Аргументы могут быть числами с плавающей запятой, например, `3.14%0.7` равно `0.34` (поскольку `3.14` равно `4*0.7 + 0.34`.) Оператор остатка всегда возвращает результат того же знака, что и его второй операнд (или ноль); абсолютное значение результата строго меньше абсолютного значения второго операнда [\[1\]](https://python-all.ru/3.5/reference/expressions.html#id16).471472Операторы целочисленного деления и остатка связаны следующим тождеством: `x == (x//y)*y + (x%y)`. Целочисленное деление и остаток также связаны со встроенной функцией [`divmod()`](https://python-all.ru/3.5/library/functions.html#divmod): `divmod(x, y) == (x//y, x%y)`. [\[2\]](https://python-all.ru/3.5/reference/expressions.html#id17).473474Помимо выполнения операции взятия остатка над числами, оператор `%` также перегружается строковыми объектами для выполнения форматирования строк в старом стиле (также известного как интерполяция). Синтаксис форматирования строк описан в справочнике по библиотеке Python, раздел [Форматирование строк в стиле printf](https://python-all.ru/3.5/library/stdtypes.html#old-string-formatting).475476Оператор целочисленного деления, оператор остатка от деления и функция [`divmod()`](https://python-all.ru/3.5/library/functions.html#divmod) не определены для комплексных чисел. Вместо этого преобразуйте их в число с плавающей запятой с помощью функции [`abs()`](https://python-all.ru/3.5/library/functions.html#abs), если это необходимо.477478Оператор `+` (сложения) возвращает сумму своих аргументов. Аргументы должны быть либо оба числами, либо оба последовательностями одного типа. В первом случае числа преобразуются к общему типу и затем складываются. Во втором случае последовательности конкатенируются.479480Оператор `-` (вычитания) возвращает разность своих аргументов. Числовые аргументы сначала преобразуются к общему типу.481482## 6.8. Операции сдвига483484Операции сдвига имеют более низкий приоритет, чем арифметические операции:485486```487488shift_expr ::= a_expr | shift_expr ( "<<" | ">>" ) a_expr489```490491Эти операторы принимают целые числа в качестве аргументов. Они сдвигают первый аргумент влево или вправо на количество бит, заданное вторым аргументом.492493Правый сдвиг на *n* бит определяется как целочисленное деление на `pow(2,n)`. Левый сдвиг на *n* бит определяется как умножение на `pow(2,n)`.494495> **Примечание**496>497> В текущей реализации правый операнд должен быть не больше [`sys.maxsize`](https://python-all.ru/3.5/library/sys.html#sys.maxsize). Если правый операнд больше [`sys.maxsize`](https://python-all.ru/3.5/library/sys.html#sys.maxsize), возбуждается исключение [`OverflowError`](https://python-all.ru/3.5/library/exceptions.html#OverflowError).498499## 6.9. Бинарные побитовые операции500501Каждая из трёх побитовых операций имеет свой уровень приоритета:502503```504505and_expr ::= shift_expr | and_expr "&" shift_expr506xor_expr ::= and_expr | xor_expr "^" and_expr507or_expr ::= xor_expr | or_expr "|" xor_expr508```509510Оператор `&` возвращает побитовое И своих аргументов, которые должны быть целыми числами.511512Оператор `^` возвращает побитовое исключающее ИЛИ (XOR) своих аргументов, которые должны быть целыми числами.513514Оператор `|` возвращает побитовое (включающее) ИЛИ своих аргументов, которые должны быть целыми числами.515516## 6.10. Сравнения517518В отличие от C, все операции сравнения в Python имеют одинаковый приоритет, который ниже приоритета любых арифметических, сдвиговых или побитовых операций. Также в отличие от C, выражения вида `a < b < c` интерпретируются так, как принято в математике:519520```521522comparison ::= or_expr ( comp_operator or_expr )*523comp_operator ::= "<" | ">" | "==" | ">=" | "<=" | "!="524 | "is" ["not"] | ["not"] "in"525```526527Сравнения возвращают логические значения: `True` или `False`.528529Сравнения можно произвольно объединять в цепочки, например, `x < y <= z` эквивалентно `x < y and y <= z`, за исключением того, что `y` вычисляется только один раз (но в обоих случаях `z` вообще не вычисляется, если `x < y` оказывается ложным).530531Формально, если *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`, за исключением того, что каждое выражение вычисляется не более одного раза.532533Обратите внимание, что `a op1 b op2 c` не подразумевает никакого сравнения между *a* и *c*, так что, например, `x < y > z` совершенно допустимо (хотя, возможно, и некрасиво).534535### 6.10.1. Сравнения значений536537Операторы `<`, `>`, `==`, `>=`, `<=` и `!=` сравнивают значения двух объектов. Объекты не обязательно должны иметь одинаковый тип.538539В главе [Объекты, значения и типы](https://python-all.ru/3.5/reference/datamodel.html#objects) говорится, что объекты имеют значение (в дополнение к типу и идентичности). Значение объекта – довольно абстрактное понятие в Python: например, не существует канонического метода доступа к значению объекта. Также не требуется, чтобы значение объекта было сформировано определённым образом, например, из всех его атрибутов данных. Операторы сравнения реализуют определённое представление о том, что является значением объекта. Можно считать, что они косвенно определяют значение объекта через свою реализацию сравнения.540541Поскольку все типы являются (прямыми или косвенными) подтипами [`object`](https://python-all.ru/3.5/library/functions.html#object), они наследуют поведение сравнения по умолчанию от [`object`](https://python-all.ru/3.5/library/functions.html#object). Типы могут настраивать своё поведение сравнения, реализуя *методы расширенного сравнения*, такие как [`__lt__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__lt__), описанные в разделе [Базовая настройка](https://python-all.ru/3.5/reference/datamodel.html#customization).542543Поведение по умолчанию для сравнения на равенство (`==` и `!=`) основано на идентичности объектов. Следовательно, сравнение на равенство экземпляров с одинаковой идентичностью даёт равенство, а сравнение экземпляров с разной идентичностью – неравенство. Мотивация такого поведения по умолчанию – желание, чтобы все объекты были рефлексивными (т.е. `x is y` влечёт `x == y`).544545Поведение сравнения порядка по умолчанию (`<`, `>`, `<=` и `>=`) не предусмотрено; попытка вызывает [`TypeError`](https://python-all.ru/3.5/library/exceptions.html#TypeError). Мотивация такого поведения по умолчанию – отсутствие аналогичного инварианта, как для равенства.546547Поведение сравнения на равенство по умолчанию, при котором экземпляры с разной идентичностью всегда неравны, может противоречить тому, что нужно типам, имеющим разумное определение значения объекта и равенства на основе значения. Таким типам потребуется настраивать своё поведение сравнения, и, в самом деле, ряд встроенных типов уже это сделал.548549Следующий список описывает поведение сравнения наиболее важных встроенных типов.550551- Числа встроенных числовых типов ([Числовые типы – int, float, complex](https://python-all.ru/3.5/library/stdtypes.html#typesnumeric)) и типов стандартной библиотеки [`fractions.Fraction`](https://python-all.ru/3.5/library/fractions.html#fractions.Fraction) и [`decimal.Decimal`](https://python-all.ru/3.5/library/decimal.html#decimal.Decimal) можно сравнивать как внутри своих типов, так и между ними, с ограничением, что комплексные числа не поддерживают сравнение порядка. В пределах задействованных типов они сравниваются математически (алгоритмически) корректно без потери точности.552553 Значения «не число» `float('NaN')` и `Decimal('NaN')` являются особыми. Они идентичны сами себе (`x is x` истинно), но не равны сами себе (`x == x` ложно). Кроме того, сравнение любого числа со значением «не число» вернёт `False`. Например, и `3 < float('NaN')`, и `float('NaN') < 3` вернут `False`.554- Бинарные последовательности (экземпляры [`bytes`](https://python-all.ru/3.5/library/functions.html#bytes) или [`bytearray`](https://python-all.ru/3.5/library/functions.html#bytearray)) можно сравнивать как внутри своих типов, так и между ними. Они сравниваются лексикографически по числовым значениям своих элементов.555- Строки (экземпляры [`str`](https://python-all.ru/3.5/library/stdtypes.html#str)) сравниваются лексикографически по числовым кодовым точкам Unicode (результат встроенной функции [`ord()`](https://python-all.ru/3.5/library/functions.html#ord)) своих символов. [\[3\]](https://python-all.ru/3.5/reference/expressions.html#id18)556557 Строки и двоичные последовательности нельзя сравнивать напрямую.558- Последовательности (экземпляры [`tuple`](https://python-all.ru/3.5/library/stdtypes.html#tuple), [`list`](https://python-all.ru/3.5/library/stdtypes.html#list) или [`range`](https://python-all.ru/3.5/library/stdtypes.html#range)) могут сравниваться только внутри каждого из своих типов, с ограничением, что диапазоны не поддерживают упорядоченное сравнение. Сравнение на равенство между этими типами приводит к неравенству, а упорядоченное сравнение между этими типами вызывает [`TypeError`](https://python-all.ru/3.5/library/exceptions.html#TypeError).559560 Последовательности сравниваются лексикографически путём сравнения соответствующих элементов, при этом обеспечивается рефлексивность элементов.561562 При обеспечении рефлексивности элементов сравнение коллекций предполагает, что для элемента коллекции `x` `x == x` всегда истинно. Исходя из этого предположения, сначала сравнивается идентичность элементов, а сравнение элементов выполняется только для различных элементов. Такой подход даёт тот же результат, что и строгое сравнение элементов, если сравниваемые элементы рефлексивны. Для нерефлексивных элементов результат отличается от строгого сравнения элементов и может быть неожиданным: например, нерефлексивные значения not-a-number приводят к следующему поведению сравнения при использовании в списке:563564 ```python565 >>> nan = float('NaN')566 >>> nan is nan567 True568 >>> nan == nan569 False <-- the defined non-reflexive behavior of NaN570 >>> [nan] == [nan]571 True <-- list enforces reflexivity and tests identity first572 ```573574 Лексикографическое сравнение между встроенными коллекциями работает следующим образом:575576 - Чтобы две коллекции были равны при сравнении, они должны быть одного типа, иметь одинаковую длину, и каждая пара соответствующих элементов должна быть равной (например, `[1,2] == (1,2)` – ложь, так как типы разные).577 - Коллекции, поддерживающие сравнение порядка, упорядочиваются так же, как и их первые неравные элементы (например, `[1,2,x] <= [1,2,y]` имеет то же значение, что и `x <= y`). Если соответствующего элемента не существует, более короткая коллекция считается меньшей (например, `[1,2] < [1,2,3]` – истина).578- Отображения (экземпляры [`dict`](https://python-all.ru/3.5/library/stdtypes.html#dict)) равны тогда и только тогда, когда они содержат одинаковые пары *(ключ, значение)*. Сравнение ключей и значений на равенство обеспечивает рефлексивность.579580 Сравнения порядка (`<`, `>`, `<=` и `>=`) вызывают [`TypeError`](https://python-all.ru/3.5/library/exceptions.html#TypeError).581- Множества (экземпляры [`set`](https://python-all.ru/3.5/library/stdtypes.html#set) или [`frozenset`](https://python-all.ru/3.5/library/stdtypes.html#frozenset)) можно сравнивать как внутри типа, так и между типами.582583 Они определяют операторы сравнения порядка как проверки на подмножество и надмножество. Эти отношения не задают полного порядка (например, два множества `{1,2}` и `{2,3}` не равны, не являются подмножеством друг друга и не являются надмножеством друг друга). Соответственно, множества не подходят в качестве аргументов для функций, зависящих от полного порядка (например, [`min()`](https://python-all.ru/3.5/library/functions.html#min), [`max()`](https://python-all.ru/3.5/library/functions.html#max) и [`sorted()`](https://python-all.ru/3.5/library/functions.html#sorted) дают неопределённые результаты, если на вход подаётся список множеств).584585 Сравнение множеств требует рефлексивности их элементов.586- У большинства других встроенных типов нет реализованных методов сравнения, поэтому они наследуют поведение сравнения по умолчанию.587588Пользовательские классы, которые настраивают своё поведение сравнения, должны по возможности следовать некоторым правилам согласованности:589590- Сравнение на равенство должно быть рефлексивным. Другими словами, идентичные объекты должны быть равны:591592 > `x is y` влечёт `x == y`593- Сравнение должно быть симметричным. Другими словами, следующие выражения должны давать одинаковый результат:594595 > `x == y` и `y == x`596 >597 > `x != y` и `y != x`598 >599 > `x < y` и `y > x`600 >601 > `x <= y` и `y >= x`602- Сравнение должно быть транзитивным. Следующие (неисчерпывающие) примеры это иллюстрируют:603604 > `x > y and y > z` влечёт `x > z`605 >606 > `x < y and y <= z` влечёт `x < z`607- Обратное сравнение должно давать логическое отрицание. Другими словами, следующие выражения должны давать одинаковый результат:608609 > `x == y` и `not x != y`610 >611 > `x < y` и `not x >= y` (для полного порядка)612 >613 > `x > y` и `not x <= y` (для полного порядка)614615 Последние два выражения применимы к полностью упорядоченным коллекциям (например, к последовательностям, но не к множествам или отображениям). См. также декоратор [`total_ordering()`](https://python-all.ru/3.5/library/functools.html#functools.total_ordering).616- Результат [`hash()`](https://python-all.ru/3.5/library/functions.html#hash) должен быть согласован с равенством. Объекты, которые равны, должны либо иметь одинаковое хеш-значение, либо быть помечены как нехешируемые.617618Python не требует соблюдения этих правил согласованности. Фактически, значения «не число» (NaN) являются примером их нарушения.619620### 6.10.2. Операции проверки принадлежности621622Операторы [`in`](https://python-all.ru/3.5/reference/expressions.html#in) и [`not in`](https://python-all.ru/3.5/reference/expressions.html#not-in) проверяют принадлежность. `x in s` вычисляется в `True`, если *x* является элементом *s*, и `False` в противном случае. `x not in s` возвращает отрицание `x in s`. Все встроенные последовательности и множества поддерживают это, а также словари, для которых [`in`](https://python-all.ru/3.5/reference/expressions.html#in) проверяет, содержит ли словарь заданный ключ. Для контейнерных типов, таких как list, tuple, set, frozenset, dict или collections.deque, выражение `x in y` эквивалентно `any(x is e or x == e for e in y)`.623624Для типов str и bytes `x in y` равно `True` тогда и только тогда, когда *x* является подстрокой *y*. Эквивалентная проверка: `y.find(x) != -1`. Пустые строки всегда считаются подстрокой любой другой строки, поэтому `"" in "abc"` вернёт `True`.625626Для пользовательских классов, которые определяют метод [`__contains__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__contains__), `x in y` возвращает `True`, если `y.__contains__(x)` возвращает истинное значение, и `False` в противном случае.627628Для определённых пользователем классов, которые не определяют [`__contains__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__contains__), но определяют [`__iter__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__iter__), `x in y` равно `True`, если при итерации по `y` порождается некоторое значение `z` с `x == z`. Если во время итерации возбуждается исключение, то это равносильно тому, что [`in`](https://python-all.ru/3.5/reference/expressions.html#in) возбудило это исключение.629630Наконец, проверяется протокол итерации старого стиля: если класс определяет [`__getitem__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__getitem__), то `x in y` равно `True` тогда и только тогда, когда существует неотрицательный целый индекс *i* такой, что `x == y[i]`, и все меньшие целые индексы не возбуждают исключение [`IndexError`](https://python-all.ru/3.5/library/exceptions.html#IndexError). (Если возбуждается любое другое исключение, то это равносильно тому, что [`in`](https://python-all.ru/3.5/reference/expressions.html#in) возбудило это исключение).631632Оператор [`not in`](https://python-all.ru/3.5/reference/expressions.html#not-in) определён как имеющий обратное истинностное значение оператора [`in`](https://python-all.ru/3.5/reference/expressions.html#in).633634### 6.10.3. Сравнения идентичности635636Операторы [`is`](https://python-all.ru/3.5/reference/expressions.html#is) и [`is not`](https://python-all.ru/3.5/reference/expressions.html#is-not) проверяют идентичность объектов: `x is y` истинно тогда и только тогда, когда *x* и *y* являются одним и тем же объектом. Идентичность объектов определяется с помощью функции [`id()`](https://python-all.ru/3.5/library/functions.html#id). `x is not y` даёт обратное истинностное значение. [\[4\]](https://python-all.ru/3.5/reference/expressions.html#id19)637638## 6.11. Булевы операции639640```641642or_test ::= and_test | or_test "or" and_test643and_test ::= not_test | and_test "and" not_test644not_test ::= comparison | "not" not_test645```646647В контексте логических операций, а также когда выражения используются в операторах управления потоком, следующие значения интерпретируются как ложные: `False`, `None`, числовой ноль всех типов, а также пустые строки и контейнеры (включая строки, кортежи, списки, словари, множества и неизменяемые множества). Все остальные значения интерпретируются как истинные. Пользовательские объекты могут настраивать своё логическое значение, предоставив метод [`__bool__()`](https://python-all.ru/3.5/reference/datamodel.html#object.__bool__).648649Оператор [`not`](https://python-all.ru/3.5/reference/expressions.html#not) возвращает `True`, если его аргумент ложен, и `False` в противном случае.650651Выражение `x and y` сначала вычисляет *x*; если *x* ложно, возвращается его значение; в противном случае вычисляется *y* и возвращается полученное значение.652653Выражение `x or y` сначала вычисляет *x*; если *x* истинно, возвращается его значение; в противном случае вычисляется *y* и возвращается полученное значение.654655(Обратите внимание, что ни [`and`](https://python-all.ru/3.5/reference/expressions.html#and), ни [`or`](https://python-all.ru/3.5/reference/expressions.html#or) не ограничивают возвращаемые значение и тип значениями `False` и `True`, а возвращают последний вычисленный аргумент. Это иногда полезно: например, если `s` – строка, которую следует заменить значением по умолчанию, если она пуста, выражение `s or 'foo'` даёт нужный результат. Поскольку [`not`](https://python-all.ru/3.5/reference/expressions.html#not) должен создать новое значение, он возвращает булево значение независимо от типа своего аргумента (например, `not 'foo'` даёт `False`, а не `''`.)656657## 6.12. Условные выражения658659```660661conditional_expression ::= or_test ["if" or_test "else" expression]662expression ::= conditional_expression | lambda_expr663expression_nocond ::= or_test | lambda_expr_nocond664```665666Условные выражения (иногда называемые «тернарным оператором») имеют самый низкий приоритет среди всех операций Python.667668Выражение `x if C else y` сначала вычисляет условие *C*, а не *x*. Если *C* истинно, вычисляется *x* и возвращается его значение; в противном случае вычисляется *y* и возвращается его значение.669670См. [**PEP 308**](https://python-all.ru/3.5/reference/expressions.html) для получения дополнительных сведений об условных выражениях.671672## 6.13. Лямбды673674```675676lambda_expr ::= "lambda" [parameter_list]: expression677lambda_expr_nocond ::= "lambda" [parameter_list]: expression_nocond678```679680Лямбда-выражения (иногда называемые лямбда-формами) используются для создания анонимных функций. Выражение `lambda arguments: expression` возвращает объект функции. Этот безымянный объект ведёт себя как объект функции, определённый с помощью:681682```text683def <lambda>(arguments):684 return expression685```686687См. раздел [Определения функций](https://python-all.ru/3.5/reference/compound_stmts.html#function) о синтаксисе списков параметров. Обратите внимание, что функции, созданные с помощью лямбда-выражений, не могут содержать инструкции или аннотации.688689## 6.14. Списки выражений690691```692693expression_list ::= expression ( "," expression )* [","]694starred_list ::= starred_item ( "," starred_item )* [","]695starred_expression ::= expression | ( starred_item "," )* [starred_item]696starred_item ::= expression | "*" or_expr697```698699За исключением случаев, когда список выражений является частью литерала списка или множества, список выражений, содержащий хотя бы одну запятую, образует кортеж. Длина кортежа равна количеству выражений в списке. Выражения вычисляются слева направо.700701Звёздочка `*` обозначает *распаковку итерируемого объекта*. Её операндом должен быть [итерируемый объект](https://python-all.ru/3.5/glossary.html#term-iterable). Итерируемый объект раскрывается в последовательность элементов, которые включаются в новый кортеж, список или множество в месте распаковки.702703Новое в версии 3.5: Распаковка итерируемых объектов в списках выражений, изначально предложенная в [**PEP 448**](https://python-all.ru/3.5/reference/expressions.html).704705Завершающая запятая требуется только для создания кортежа из одного элемента (т.н. *синглетон*); во всех остальных случаях она необязательна. Одиночное выражение без завершающей запятой не создаёт кортеж, а возвращает значение этого выражения. (Чтобы создать пустой кортеж, используйте пустую пару круглых скобок: `()`.)706707## 6.15. Порядок вычисления708709Python вычисляет выражения слева направо. Обратите внимание, что при вычислении присваивания сначала вычисляется правая часть, а затем левая.710711В следующих строках выражения будут вычисляться в арифметическом порядке их суффиксов:712713```python714expr1, expr2, expr3, expr4715(expr1, expr2, expr3, expr4)716{expr1: expr2, expr3: expr4}717expr1 + expr2 * (expr3 - expr4)718expr1(expr2, expr3, *expr4, **expr5)719expr3, expr4 = expr1, expr2720```721722## 6.16. Приоритет операторов723724В следующей таблице приведён приоритет операторов в Python от самого низкого (наименее связывающего) до самого высокого (наиболее связывающего). Операторы в одной ячейке имеют одинаковый приоритет. Если синтаксис не указан явно, операторы являются бинарными. Операторы в одной ячейке группируются слева направо (за исключением возведения в степень, которое группируется справа налево).725726Сравнения, проверки принадлежности и проверки тождественности имеют одинаковый приоритет и связываются слева направо, как описано в разделе [Сравнения](https://python-all.ru/3.5/reference/expressions.html#comparisons).727728| Оператор | Описание |729| --- | --- |730| [`lambda`](https://python-all.ru/3.5/reference/expressions.html#lambda) | Лямбда-выражение |731| [`if`](https://python-all.ru/3.5/reference/compound_stmts.html#if) – [`else`](https://python-all.ru/3.5/reference/compound_stmts.html#else) | Условное выражение |732| [`or`](https://python-all.ru/3.5/reference/expressions.html#or) | Логическое ИЛИ |733| [`and`](https://python-all.ru/3.5/reference/expressions.html#and) | Логическое И |734| [`not`](https://python-all.ru/3.5/reference/expressions.html#not) `x` | Логическое НЕ |735| [`in`](https://python-all.ru/3.5/reference/expressions.html#in), [`not in`](https://python-all.ru/3.5/reference/expressions.html#not-in), [`is`](https://python-all.ru/3.5/reference/expressions.html#is), [`is not`](https://python-all.ru/3.5/reference/expressions.html#is-not), `<`, `<=`, `>`, `>=`, `!=`, `==` | Сравнения, включая проверки принадлежности и тождественности |736| `\|` | Побитовое ИЛИ |737| `^` | Побитовое исключающее ИЛИ |738| `&` | Побитовое И |739| `<<`, `>>` | Сдвиги |740| `+`, `-` | Сложение и вычитание |741| `*`, `@`, `/`, `//`, `%` | Умножение, матричное умножение, деление, остаток [\[5\]](https://python-all.ru/3.5/reference/expressions.html#id20) |742| `+x`, `-x`, `~x` | Унарный плюс, унарный минус, побитовое НЕ |743| `**` | Возведение в степень [\[6\]](https://python-all.ru/3.5/reference/expressions.html#id21) |744| `await` `x` | Выражение await |745| `x[index]`, `x[index:index]`, `x(arguments...)`, `x.attribute` | Индексация, срез, вызов, ссылка на атрибут |746| `(expressions...)`, `[expressions...]`, `{key: value...}`, `{expressions...}` | Связывание или отображение кортежа, отображение списка, отображение словаря, отображение множества |747748Сноски749750| [\[1\]](https://python-all.ru/3.5/reference/expressions.html#id8) | Хотя математически `abs(x%y) < abs(y)` истинно, для чисел с плавающей запятой оно может не выполняться численно из-за округления. Например, если предположить платформу, на которой число с плавающей запятой Python является числом двойной точности IEEE 754, то чтобы `-1e-100 % 1e100` имело тот же знак, что и `1e100`, вычисленный результат равен `-1e-100 + 1e100`, что численно в точности равно `1e100`. Функция [`math.fmod()`](https://python-all.ru/3.5/library/math.html#math.fmod) вместо этого возвращает результат, знак которого совпадает со знаком первого аргумента, поэтому в данном случае возвращает `-1e-100`. Какой подход более уместен, зависит от приложения. |751| --- | --- |752753| [\[2\]](https://python-all.ru/3.5/reference/expressions.html#id9) | Если x очень близок к целому кратному y, возможно, что `x//y` будет на единицу больше `(x-x%y)//y` из-за округления. В таких случаях Python возвращает последний результат, чтобы `divmod(x,y)[0] * y + x % y` оставался очень близким к `x`. |754| --- | --- |755756| [\[3\]](https://python-all.ru/3.5/reference/expressions.html#id11) | Стандарт 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). Операторы сравнения строк сравнивают на уровне кодовых точек Unicode. Это может быть неинтуитивно для человека. Например, `"\u00C7" == "\u0043\u0327"` равно `False`, хотя обе строки представляют один и тот же абстрактный символ «LATIN CAPITAL LETTER C WITH CEDILLA». Для сравнения строк на уровне абстрактных символов (то есть интуитивно понятным способом) используется [`unicodedata.normalize()`](https://python-all.ru/3.5/library/unicodedata.html#unicodedata.normalize). |757| --- | --- |758759| [\[4\]](https://python-all.ru/3.5/reference/expressions.html#id12) | Из-за автоматической сборки мусора, списков свободных объектов и динамической природы дескрипторов может наблюдаться, казалось бы, необычное поведение при определённых использованиях оператора [`is`](https://python-all.ru/3.5/reference/expressions.html#is), например, при сравнениях между методами экземпляров или константами. За дополнительной информацией обратитесь к их документации. |760| --- | --- |761762| [\[5\]](https://python-all.ru/3.5/reference/expressions.html#id14) | Оператор `%` также используется для форматирования строк; для него действует тот же приоритет. |763| --- | --- |764765| [\[6\]](https://python-all.ru/3.5/reference/expressions.html#id15) | Оператор возведения в степень `**` связывает менее тесно, чем арифметический или побитовый унарный оператор справа от него, то есть `2**-1` равно `0.5`. |766| --- | --- |767