languages/cpython
languages/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython synced 2024-10-08 20:10:00 +00:00
Code Issues Packages Projects Releases Wiki Activity

SF patch #760792: "wo" in "word" now valid but not documented as such

Browse source 
Revised version of a contribution from Gerrit Holl.

Update the docs for the extended behavior of __contains__
This commit is contained in:
Raymond Hettinger 2003-06-26 19:32:10 +00:00
parent f6fe4eda6e
commit d0cda1dc9f
1 changed files with 7 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
Doc/ref/ref5.tex
View file

@ -913,10 +913,13 @@ only if there exists an index \var{i} such that
\code{\var{x} == \var{y}[\var{i}]} is true.
For the Unicode and string types, \code{\var{x} in \var{y}} is true if
and only if there exists an index \var{i} such that \code{\var{x} ==
\var{y}[\var{i}]} is true. If \code{\var{x}} is not a string or
Unicode object of length \code{1}, a \exception{TypeError} exception
is raised.
and only if \var{x} is a substring of \var{y}. An equivalent test is
\code{y.find(x) != -1}. Note, \var{x} and \var{y} need not be the
same type; consequently, \code{u'ab' in 'abc'} will return \code{True}.
Empty strings are always considered to be a substring of any other string,
so \code{"" in "abc"} will return \code{True}.
\versionchanged[Previously, \var{x} was required to be a string of
length \code{1}]{2.3}
For user-defined classes which define the \method{__contains__()} method,
\code{\var{x} in \var{y}} is true if and only if