Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-12-08 06:10:17 +00:00
Code Issues Projects Releases Packages Wiki Activity

[3.14] gh-135676: Reword the Operators & Delimiters section(s) (GH-137713) (#138457)

Browse source 
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2025-09-11 11:22:56 +02:00 • committed by GitHub
parent dd930baf45
commit 15ca9c6816
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 44 additions and 49 deletions
Download patch file Download diff file Expand all files Collapse all files

93
Doc/reference/lexical_analysis.rst
View file

@ -1351,67 +1351,62 @@ Formally, imaginary literals are described by the following lexical definition:
imagnumber: (`floatnumber` | `digitpart`) ("j" | "J")
.. _operators:
Operators
=========
.. index:: single: operators
The following tokens are operators:
.. code-block:: none
+ - * ** / // % @
<< >> & | ^ ~ :=
< > <= >= == !=
.. _delimiters:
Delimiters
==========
.. index:: single: delimiters
The following tokens serve as delimiters in the grammar:
.. code-block:: none
( ) [ ] { }
, : ! . ; @ =
The period can also occur in floating-point and imaginary literals.
.. _operators:
.. _lexical-ellipsis:
A sequence of three periods has a special meaning as an
:py:data:`Ellipsis` literal:
Operators and delimiters
========================
.. code-block:: none
.. index::
single: operators
single: delimiters
...
The following grammar defines :dfn:`operator` and :dfn:`delimiter` tokens,
that is, the generic :data:`~token.OP` token type.
A :ref:`list of these tokens and their names <token_operators_delimiters>`
is also available in the :mod:`!token` module documentation.
The following *augmented assignment operators* serve
lexically as delimiters, but also perform an operation:
.. grammar-snippet::
:group: python-grammar
.. code-block:: none
OP:
| assignment_operator
| bitwise_operator
| comparison_operator
| enclosing_delimiter
| other_delimiter
| arithmetic_operator
| "..."
| other_op
-> += -= *= /= //= %=
@= &= |= ^= >>= <<= **=
assignment_operator: "+=" | "-=" | "*=" | "**=" | "/=" | "//=" | "%=" |
"&=" | "|=" | "^=" | "<<=" | ">>=" | "@=" | ":="
bitwise_operator: "&" | "|" | "^" | "~" | "<<" | ">>"
comparison_operator: "<=" | ">=" | "<" | ">" | "==" | "!="
enclosing_delimiter: "(" | ")" | "[" | "]" | "{" | "}"
other_delimiter: "," | ":" | "!" | ";" | "=" | "->"
arithmetic_operator: "+" | "-" | "**" | "*" | "//" | "/" | "%"
other_op: "." | "@"
The following printing ASCII characters have special meaning as part of other
tokens or are otherwise significant to the lexical analyzer:
.. note::
.. code-block:: none
Generally, *operators* are used to combine :ref:`expressions <expressions>`,
while *delimiters* serve other purposes.
However, there is no clear, formal distinction between the two categories.
' " # \
Some tokens can serve as either operators or delimiters, depending on usage.
For example, ``*`` is both the multiplication operator and a delimiter used
for sequence unpacking, and ``@`` is both the matrix multiplication and
a delimiter that introduces decorators.
The following printing ASCII characters are not used in Python. Their
occurrence outside string literals and comments is an unconditional error:
For some tokens, the distinction is unclear.
For example, some people consider ``.``, ``(``, and ``)`` to be delimiters, while others
see the :py:func:`getattr` operator and the function call operator(s).
.. code-block:: none
Some of Python's operators, like ``and``, ``or``, and ``not in``, use
:ref:`keyword <keywords>` tokens rather than "symbols" (operator tokens).
$ ? `
A sequence of three consecutive periods (``...``) has a special
meaning as an :py:data:`Ellipsis` literal.