From: Fred Drake <fdrake@acm.org>
Date: Fri, 1 Nov 2002 21:34:39 +0000 (+0000)
Subject: Update example for the type() function to use the currently accepted
X-Git-Tag: v2.2.3c1~261
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=80ee73809a550153426d8de841092aecd67aad32;p=thirdparty%2FPython%2Fcpython.git

Update example for the type() function to use the currently accepted
preference of using "is" instead of "==" to compare types, use
built-in names where available, and point to the isinstance()
function.
Closes SF bug #632196.
---

diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex
index 37cb34920042..7a7d764916d8 100644
--- a/Doc/lib/libfuncs.tex
+++ b/Doc/lib/libfuncs.tex
@@ -799,13 +799,24 @@ def my_import(name):
   Return the type of an \var{object}.  The return value is a
   type\obindex{type} object.  The standard module
   \module{types}\refstmodindex{types} defines names for all built-in
-  types.
+  types that don't already have built-in names.
   For instance:
 
 \begin{verbatim}
 >>> import types
->>> if type(x) == types.StringType: print "It's a string"
+>>> x = 'abc'
+>>> if type(x) is str: print "It's a string"
+...
+It's a string
+>>> def f(): pass
+...
+>>> if type(f) is types.FunctionType: print "It's a function"
+...
+It's a function
 \end{verbatim}
+
+  The \function{isinstance()} built-in function is recommended for
+  testing the type of an object.
 \end{funcdesc}
 
 \begin{funcdesc}{unichr}{i}