]> granicus.if.org Git - python/commitdiff
Added docs for replace() and replace1().
authorGuido van Rossum <guido@python.org>
Tue, 25 Mar 1997 16:41:31 +0000 (16:41 +0000)
committerGuido van Rossum <guido@python.org>
Tue, 25 Mar 1997 16:41:31 +0000 (16:41 +0000)
Doc/lib/libstring.tex
Doc/libstring.tex

index 80222c117b8c3e10fc33035f952f5ac636c117f0..284782a914f4b2f5f881d0ec856d97b06523acf3 100644 (file)
@@ -227,6 +227,19 @@ Pad a numeric string on the left with zero digits until the given
 width is reached.  Strings starting with a sign are handled correctly.
 \end{funcdesc}
 
+\begin{funcdesc}{replace}{old, new, str}
+Return a copy of string \var{str} with all occurrences of substring
+\var{old} replaced by \var{new}.
+\end{funcdesc}
+
+\begin{funcdesc}{replace1}{old, new, str\optional{, start\optional{, end}}}
+Return a copy of string \var{str} with the first occurrence of
+substring \var{old} replaced by \var{new}.  If no occurrence is found,
+\var{str} is returned unchanged.  Optional arguments \var{start} and
+\var{end} limit the search for \var{old} like for \code{find} (they
+are not used to slice the result).
+\end{funcdesc}
+
 This module is implemented in Python.  Much of its functionality has
 been reimplemented in the built-in module \code{strop}.  However, you
 should \emph{never} import the latter module directly.  When
index 80222c117b8c3e10fc33035f952f5ac636c117f0..284782a914f4b2f5f881d0ec856d97b06523acf3 100644 (file)
@@ -227,6 +227,19 @@ Pad a numeric string on the left with zero digits until the given
 width is reached.  Strings starting with a sign are handled correctly.
 \end{funcdesc}
 
+\begin{funcdesc}{replace}{old, new, str}
+Return a copy of string \var{str} with all occurrences of substring
+\var{old} replaced by \var{new}.
+\end{funcdesc}
+
+\begin{funcdesc}{replace1}{old, new, str\optional{, start\optional{, end}}}
+Return a copy of string \var{str} with the first occurrence of
+substring \var{old} replaced by \var{new}.  If no occurrence is found,
+\var{str} is returned unchanged.  Optional arguments \var{start} and
+\var{end} limit the search for \var{old} like for \code{find} (they
+are not used to slice the result).
+\end{funcdesc}
+
 This module is implemented in Python.  Much of its functionality has
 been reimplemented in the built-in module \code{strop}.  However, you
 should \emph{never} import the latter module directly.  When