Kaydet (Commit) ad351f80 authored tarafından Raymond Hettinger's avatar Raymond Hettinger

SF bug #1178269 Clarify when isMappingType/isSequenceType is True.

üst fb5f04d7
...@@ -262,7 +262,8 @@ unbound methods, class objects, and instance objects which support the ...@@ -262,7 +262,8 @@ unbound methods, class objects, and instance objects which support the
\begin{funcdesc}{isMappingType}{o} \begin{funcdesc}{isMappingType}{o}
Returns true if the object \var{o} supports the mapping interface. Returns true if the object \var{o} supports the mapping interface.
This is true for dictionaries and all instance objects. This is true for dictionaries and all instance objects defining
\method{__getitem__}.
\warning{There is no reliable way to test if an instance \warning{There is no reliable way to test if an instance
supports the complete mapping protocol since the interface itself is supports the complete mapping protocol since the interface itself is
ill-defined. This makes this test less useful than it otherwise might ill-defined. This makes this test less useful than it otherwise might
...@@ -271,7 +272,7 @@ be.} ...@@ -271,7 +272,7 @@ be.}
\begin{funcdesc}{isNumberType}{o} \begin{funcdesc}{isNumberType}{o}
Returns true if the object \var{o} represents a number. This is true Returns true if the object \var{o} represents a number. This is true
for all numeric types implemented in C, and for all instance objects. for all numeric types implemented in C.
\warning{There is no reliable way to test if an instance \warning{There is no reliable way to test if an instance
supports the complete numeric interface since the interface itself is supports the complete numeric interface since the interface itself is
ill-defined. This makes this test less useful than it otherwise might ill-defined. This makes this test less useful than it otherwise might
...@@ -281,7 +282,8 @@ be.} ...@@ -281,7 +282,8 @@ be.}
\begin{funcdesc}{isSequenceType}{o} \begin{funcdesc}{isSequenceType}{o}
Returns true if the object \var{o} supports the sequence protocol. Returns true if the object \var{o} supports the sequence protocol.
This returns true for all objects which define sequence methods in C, This returns true for all objects which define sequence methods in C,
and for all instance objects. \warning{There is no reliable and for all instance objects defining \method{__getitem__}.
\warning{There is no reliable
way to test if an instance supports the complete sequence interface way to test if an instance supports the complete sequence interface
since the interface itself is ill-defined. This makes this test less since the interface itself is ill-defined. This makes this test less
useful than it otherwise might be.} useful than it otherwise might be.}
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment