diff options
author | Ezio Melotti <ezio.melotti@gmail.com> | 2012-10-24 20:06:25 (GMT) |
---|---|---|
committer | Ezio Melotti <ezio.melotti@gmail.com> | 2012-10-24 20:06:25 (GMT) |
commit | 837cd06d36f7e69fc51e5bce7631041161f9b864 (patch) | |
tree | 729c295211375657d7a49282e3b56a1dad1832a9 /Doc/library/functions.rst | |
parent | fdf0f274e63ab45de33e81c016e97dc8640265e9 (diff) | |
download | cpython-837cd06d36f7e69fc51e5bce7631041161f9b864.zip cpython-837cd06d36f7e69fc51e5bce7631041161f9b864.tar.gz cpython-837cd06d36f7e69fc51e5bce7631041161f9b864.tar.bz2 |
#16210: combine the two type() docs. Patch by Pete Sevander.
Diffstat (limited to 'Doc/library/functions.rst')
-rw-r--r-- | Doc/library/functions.rst | 26 |
1 files changed, 11 insertions, 15 deletions
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index b7d7e08..31d8cf1 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1353,29 +1353,25 @@ are always available. They are listed here in alphabetical order. .. function:: type(object) + type(name, bases, dict) .. index:: object: type - Return the type of an *object*. The return value is a type object and - generally the same object as returned by ``object.__class__``. + + With one argument, return the type of an *object*. The return value is a + type object and generally the same object as returned by ``object.__class__``. The :func:`isinstance` built-in function is recommended for testing the type of an object, because it takes subclasses into account. - With three arguments, :func:`type` functions as a constructor as detailed - below. - - -.. function:: type(name, bases, dict) - :noindex: - Return a new type object. This is essentially a dynamic form of the - :keyword:`class` statement. The *name* string is the class name and becomes the - :attr:`__name__` attribute; the *bases* tuple itemizes the base classes and - becomes the :attr:`__bases__` attribute; and the *dict* dictionary is the - namespace containing definitions for class body and becomes the :attr:`__dict__` - attribute. For example, the following two statements create identical - :class:`type` objects: + With three arguments, return a new type object. This is essentially a + dynamic form of the :keyword:`class` statement. The *name* string is the + class name and becomes the :attr:`__name__` attribute; the *bases* tuple + itemizes the base classes and becomes the :attr:`__bases__` attribute; + and the *dict* dictionary is the namespace containing definitions for class + body and becomes the :attr:`__dict__` attribute. For example, the + following two statements create identical :class:`type` objects: >>> class X: ... a = 1 |