mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-10-17 12:18:23 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

bpo-41810: Reintroduce types.EllipsisType, .NoneType & .NotImplementedType (GH-22336)

Browse source 
closes issue 41810
This commit is contained in:
Bas van Beek 2020-09-22 17:55:34 +02:00 • committed by GitHub
parent a68a2ad19c
commit 0d0e9fe2ff
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
7 changed files with 54 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

13
Doc/library/constants.rst
View file

@ -19,19 +19,21 @@ A small number of constants live in the built-in namespace. They are:
.. data:: None
The sole value of the type ``NoneType``. ``None`` is frequently used to
represent the absence of a value, as when default arguments are not passed to a
function. Assignments to ``None`` are illegal and raise a :exc:`SyntaxError`.
An object frequently used to represent the absence of a value, as when
default arguments are not passed to a function. Assignments to ``None``
are illegal and raise a :exc:`SyntaxError`.
``None`` is the sole instance of the :data:`NoneType` type.
.. data:: NotImplemented
Special value which should be returned by the binary special methods
A special value which should be returned by the binary special methods
(e.g. :meth:`__eq__`, :meth:`__lt__`, :meth:`__add__`, :meth:`__rsub__`,
etc.) to indicate that the operation is not implemented with respect to
the other type; may be returned by the in-place binary special methods
(e.g. :meth:`__imul__`, :meth:`__iand__`, etc.) for the same purpose.
It should not be evaluated in a boolean context.
``NotImplemented`` is the sole instance of the :data:`types.NotImplementedType` type.
.. note::
@ -59,8 +61,9 @@ A small number of constants live in the built-in namespace. They are:
.. index:: single: ...; ellipsis literal
.. data:: Ellipsis
The same as the ellipsis literal "``...``". Special value used mostly in conjunction
The same as the ellipsis literal "``...``". Special value used mostly in conjunction
with extended slicing syntax for user-defined container data types.
``Ellipsis`` is the sole instance of the :data:`types.EllipsisType` type.
.. data:: __debug__

21
Doc/library/types.rst
View file

@ -103,6 +103,13 @@ If you instantiate any of these types, note that signatures may vary between Pyt
Standard names are defined for the following types:
.. data:: NoneType
The type of :data:`None`.
.. versionadded:: 3.10
.. data:: FunctionType
LambdaType
@ -186,6 +193,13 @@ Standard names are defined for the following types:
.. versionadded:: 3.7
.. data:: NotImplementedType
The type of :data:`NotImplemented`.
.. versionadded:: 3.10
.. data:: MethodDescriptorType
The type of methods of some built-in data types such as :meth:`str.join`.
@ -236,6 +250,13 @@ Standard names are defined for the following types:
Defaults to ``None``. Previously the attribute was optional.
.. data:: EllipsisType
The type of :data:`Ellipsis`.
.. versionadded:: 3.10
.. class:: TracebackType(tb_next, tb_frame, tb_lasti, tb_lineno)
The type of traceback objects such as found in ``sys.exc_info()[2]``.