[Python-3000-checkins] r65994 - python/branches/py3k/Doc/library/types.rst

[georg.brandl]

Author: georg.brandl
Date: Sat Aug 23 17:14:57 2008
New Revision: 65994

Log:
Remove outdated example from types module doc. Since the types left
in the modules are obscure, I didn't add a substitute example.


Modified:
python/branches/py3k/Doc/library/types.rst

Modified: python/branches/py3k/Doc/library/types.rst
==============================================================================
--- python/branches/py3k/Doc/library/types.rst (original)
+++ python/branches/py3k/Doc/library/types.rst Sat Aug 23 17:14:57 2008
@@ -1,4 +1,3 @@
-
:mod:`types` --- Names for built-in types
=========================================

@@ -7,41 +6,19 @@


This module defines names for some object types that are used by the standard
-Python interpreter, but not for the types defined by various extension modules.
-Also, it does not include some of the types that arise during processing such as
-the ``listiterator`` type. New names exported by future versions of this module
-will all end in ``Type``.
-
-Typical use is for functions that do different things depending on their
-argument types, like the following::
-
- from types import IntType
- def delete(mylist, item):
- if type(item) is IntType:
- del mylist[item]
- else:
- mylist.remove(item)
-
-Starting in Python 2.2, built-in factory functions such as :func:`int` and
-:func:`str` are also names for the corresponding types. This is now the
-preferred way to access the type instead of using the :mod:`types` module.
-Accordingly, the example above should be written as follows::
-
- def delete(mylist, item):
- if isinstance(item, int):
- del mylist[item]
- else:
- mylist.remove(item)
+Python interpreter, but not exposed as builtins like :class:`int` or
+:class:`str` are. Also, it does not include some of the types that arise
+transparently during processing such as the ``listiterator`` type.

-Starting in Python 3.0 all types that are also available as builtins are no
-longer exposed through the types module.
+Typical use is for :func:`isinstance` or :func:`issubclass` checks.

The module defines the following names:

.. data:: FunctionType
LambdaType

- The type of user-defined functions and lambdas.
+ The type of user-defined functions and functions created by :keyword:`lambda`
+ expressions.


.. data:: GeneratorType
@@ -65,7 +42,9 @@
.. data:: BuiltinFunctionType
BuiltinMethodType

- The type of built-in functions like :func:`len` or :func:`sys.exit`.
+ The type of built-in functions like :func:`len` or :func:`sys.exit`, and
+ methods of built-in classes. (Here, the term "built-in" means "written in
+ C".)


.. data:: ModuleType