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

gh-141623: operator.rst: don't use term "bitwise" (GH-141846)

Browse source
This commit is contained in:
Doron Behar 2026-06-08 15:12:48 +03:00 • committed by GitHub
parent e3762114e5
commit bd5fa31c5f
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 18 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

31
Doc/library/operator.rst
View file

@ -110,7 +110,7 @@ The mathematical and bitwise operations are the most numerous:
.. function:: and_(a, b)
__and__(a, b)
Return the bitwise and of *a* and *b*.
Return ``a & b``.
.. function:: floordiv(a, b)
@ -134,13 +134,13 @@ The mathematical and bitwise operations are the most numerous:
__inv__(obj)
__invert__(obj)
Return the bitwise inverse of the number *obj*. This is equivalent to ``~obj``.
Return ``~obj``.
.. function:: lshift(a, b)
__lshift__(a, b)
Return *a* shifted left by *b*.
Return ``a << b``.
.. function:: mod(a, b)
@ -152,7 +152,7 @@ The mathematical and bitwise operations are the most numerous:
.. function:: mul(a, b)
__mul__(a, b)
Return ``a * b``, for *a* and *b* numbers.
Return ``a * b``.
.. function:: matmul(a, b)
@ -172,25 +172,25 @@ The mathematical and bitwise operations are the most numerous:
.. function:: or_(a, b)
__or__(a, b)
Return the bitwise or of *a* and *b*.
Return ``a | b``.
.. function:: pos(obj)
__pos__(obj)
Return *obj* positive (``+obj``).
Return ``+obj``.
.. function:: pow(a, b)
__pow__(a, b)
Return ``a ** b``, for *a* and *b* numbers.
Return ``a ** b``.
.. function:: rshift(a, b)
__rshift__(a, b)
Return *a* shifted right by *b*.
Return ``a >> b``.
.. function:: sub(a, b)
@ -209,7 +209,7 @@ The mathematical and bitwise operations are the most numerous:
.. function:: xor(a, b)
__xor__(a, b)
Return the bitwise exclusive or of *a* and *b*.
Return ``a ^ b``.
Operations which work with sequences (some of them with mappings too) include:
@ -403,13 +403,18 @@ Python syntax and the functions in the :mod:`!operator` module.
+-----------------------+-------------------------+---------------------------------------+
| Division | ``a // b`` | ``floordiv(a, b)`` |
+-----------------------+-------------------------+---------------------------------------+
| Bitwise And | ``a & b`` | ``and_(a, b)`` |
| Bitwise And, or | ``a & b`` | ``and_(a, b)`` |
| Intersection | | |
+-----------------------+-------------------------+---------------------------------------+
| Bitwise Exclusive Or | ``a ^ b`` | ``xor(a, b)`` |
| Bitwise Exclusive Or, | ``a ^ b`` | ``xor(a, b)`` |
| or Symmetric | | |
| Difference | | |
+-----------------------+-------------------------+---------------------------------------+
| Bitwise Inversion | ``~ a`` | ``invert(a)`` |
| Bitwise Inversion, or | ``~ a`` | ``invert(a)`` |
| Complement | | |
+-----------------------+-------------------------+---------------------------------------+
| Bitwise Or | ``a | b`` | ``or_(a, b)`` |
| Bitwise Or, or | ``a | b`` | ``or_(a, b)`` |
| Union | | |
+-----------------------+-------------------------+---------------------------------------+
| Exponentiation | ``a ** b`` | ``pow(a, b)`` |
+-----------------------+-------------------------+---------------------------------------+