summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1997-10-20 22:40:26 (GMT)
committerGuido van Rossum <guido@python.org>1997-10-20 22:40:26 (GMT)
commit828a0bdb1df3003dc78bdae23281744fb8bbcb82 (patch)
tree0dd6f073eff3723e3e5b004c476c535f44c356c9 /Doc
parent871cf161f12c3ac273327de6c9171d5c2f868480 (diff)
downloadcpython-828a0bdb1df3003dc78bdae23281744fb8bbcb82.zip
cpython-828a0bdb1df3003dc78bdae23281744fb8bbcb82.tar.gz
cpython-828a0bdb1df3003dc78bdae23281744fb8bbcb82.tar.bz2
count() now has a 4th parameter too. Also rephrased the docs for find
to use the same, better words to explain start/end.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/lib/libstring.tex21
-rw-r--r--Doc/libstring.tex21
2 files changed, 18 insertions, 24 deletions
diff --git a/Doc/lib/libstring.tex b/Doc/lib/libstring.tex
index 930ce22..3d0631a 100644
--- a/Doc/lib/libstring.tex
+++ b/Doc/lib/libstring.tex
@@ -110,14 +110,11 @@ sequences.
\end{funcdesc}
\begin{funcdesc}{find}{s\, sub\optional{\, start\optional{\,end}}}
-Return the lowest index in \var{s} not smaller than \var{start} and not
-greater than \var{end} where the substring \var{sub} is found. Return
-\code{-1} when \var{sub} does not occur as a substring of \var{s} with
-index at least \var{start} and less than \var{end}.
-If \var{start} is omitted, it defaults to \code{0}. If \var{start} is
-negative, \code{len(\var{s})} is added.
-If \var{end} is omitted, it defaults to \code{len(\var{s})}. If
-\var{end} is negative, \code{len(\var{s})} is added.
+Return the lowest index in \var{s} where the substring \var{sub} is
+found such that \var{sub} is wholly contained in
+\code{\var{s}[\var{start}:\var{end}]}. Return -1 on failure.
+Defaults for \var{start} and \var{end} and interpretation of negative
+values is the same as for slices.
\end{funcdesc}
\begin{funcdesc}{rfind}{s\, sub\optional{\, start\optional{\,end}}}
@@ -134,11 +131,11 @@ Like \code{rfind} but raise \code{ValueError} when the substring is
not found.
\end{funcdesc}
-\begin{funcdesc}{count}{s\, sub\optional{\, start}}
+\begin{funcdesc}{count}{s\, sub\optional{\, start\optional{\,end}}}
Return the number of (non-overlapping) occurrences of substring
-\var{sub} in string \var{s} with index at least \var{start}.
-If \var{start} is omitted, it defaults to \code{0}. If \var{start} is
-negative, \code{len(\var{s})} is added.
+\var{sub} in string \code{\var{s}[\var{start}:\var{end}]}.
+Defaults for \var{start} and \var{end} and interpretation of negative
+values is the same as for slices.
\end{funcdesc}
\begin{funcdesc}{lower}{s}
diff --git a/Doc/libstring.tex b/Doc/libstring.tex
index 930ce22..3d0631a 100644
--- a/Doc/libstring.tex
+++ b/Doc/libstring.tex
@@ -110,14 +110,11 @@ sequences.
\end{funcdesc}
\begin{funcdesc}{find}{s\, sub\optional{\, start\optional{\,end}}}
-Return the lowest index in \var{s} not smaller than \var{start} and not
-greater than \var{end} where the substring \var{sub} is found. Return
-\code{-1} when \var{sub} does not occur as a substring of \var{s} with
-index at least \var{start} and less than \var{end}.
-If \var{start} is omitted, it defaults to \code{0}. If \var{start} is
-negative, \code{len(\var{s})} is added.
-If \var{end} is omitted, it defaults to \code{len(\var{s})}. If
-\var{end} is negative, \code{len(\var{s})} is added.
+Return the lowest index in \var{s} where the substring \var{sub} is
+found such that \var{sub} is wholly contained in
+\code{\var{s}[\var{start}:\var{end}]}. Return -1 on failure.
+Defaults for \var{start} and \var{end} and interpretation of negative
+values is the same as for slices.
\end{funcdesc}
\begin{funcdesc}{rfind}{s\, sub\optional{\, start\optional{\,end}}}
@@ -134,11 +131,11 @@ Like \code{rfind} but raise \code{ValueError} when the substring is
not found.
\end{funcdesc}
-\begin{funcdesc}{count}{s\, sub\optional{\, start}}
+\begin{funcdesc}{count}{s\, sub\optional{\, start\optional{\,end}}}
Return the number of (non-overlapping) occurrences of substring
-\var{sub} in string \var{s} with index at least \var{start}.
-If \var{start} is omitted, it defaults to \code{0}. If \var{start} is
-negative, \code{len(\var{s})} is added.
+\var{sub} in string \code{\var{s}[\var{start}:\var{end}]}.
+Defaults for \var{start} and \var{end} and interpretation of negative
+values is the same as for slices.
\end{funcdesc}
\begin{funcdesc}{lower}{s}