From 740eb8265f1c98290615bc1be3d3444d3173ac92 Mon Sep 17 00:00:00 2001 From: Guido van Rossum Date: Wed, 2 Apr 1997 05:56:16 +0000 Subject: [PATCH] Add cross-refs for int() to atoi() etc. Change replace() arguments; remove replace1(). --- Doc/lib/libstring.tex | 29 ++++++++++++++--------------- Doc/libstring.tex | 29 ++++++++++++++--------------- 2 files changed, 28 insertions(+), 30 deletions(-) diff --git a/Doc/lib/libstring.tex b/Doc/lib/libstring.tex index 284782a914f..ccbb10556de 100644 --- a/Doc/lib/libstring.tex +++ b/Doc/lib/libstring.tex @@ -58,7 +58,8 @@ The functions defined in this module are: \begin{funcdesc}{atof}{s} Convert a string to a floating point number. The string must have the standard syntax for a floating point literal in Python, optionally -preceded by a sign (\samp{+} or \samp{-}). +preceded by a sign (\samp{+} or \samp{-}). Note that this behaves +identical to the built-in function \code{float()} when passed a string. \end{funcdesc} \begin{funcdesc}{atoi}{s\optional{\, base}} @@ -68,9 +69,11 @@ sign (\samp{+} or \samp{-}). The \var{base} defaults to 10. If it is 0, a default base is chosen depending on the leading characters of the string (after stripping the sign): \samp{0x} or \samp{0X} means 16, \samp{0} means 8, anything else means 10. If \var{base} is 16, a -leading \samp{0x} or \samp{0X} is always accepted. (Note: for a more -flexible interpretation of numeric literals, use the built-in function -\code{eval()}.) +leading \samp{0x} or \samp{0X} is always accepted. Note that when +invoked without \var{base} or with \var{base} set to 10, this behaves +identical to the built-in function \code{int()} when passed a string. +(Also note: for a more flexible interpretation of numeric literals, +use the built-in function \code{eval()}.) \bifuncindex{eval} \end{funcdesc} @@ -79,7 +82,9 @@ Convert string \var{s} to a long integer in the given \var{base}. The string must consist of one or more digits, optionally preceded by a sign (\samp{+} or \samp{-}). The \var{base} argument has the same meaning as for \code{atoi()}. A trailing \samp{l} or \samp{L} is not -allowed, except if the base is 0. +allowed, except if the base is 0. Note that when invoked without +\var{base} or with \var{base} set to 10, this behaves identical to the +built-in function \code{long()} when passed a string. \end{funcdesc} \begin{funcdesc}{capitalize}{word} @@ -227,17 +232,11 @@ 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} +\begin{funcdesc}{replace}{str, old, new\optional{, maxsplit}} 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). +\var{old} replaced by \var{new}. If the optional argument +\var{maxsplit} is given, the first \var{maxsplit} occurrences are +replaced. \end{funcdesc} This module is implemented in Python. Much of its functionality has diff --git a/Doc/libstring.tex b/Doc/libstring.tex index 284782a914f..ccbb10556de 100644 --- a/Doc/libstring.tex +++ b/Doc/libstring.tex @@ -58,7 +58,8 @@ The functions defined in this module are: \begin{funcdesc}{atof}{s} Convert a string to a floating point number. The string must have the standard syntax for a floating point literal in Python, optionally -preceded by a sign (\samp{+} or \samp{-}). +preceded by a sign (\samp{+} or \samp{-}). Note that this behaves +identical to the built-in function \code{float()} when passed a string. \end{funcdesc} \begin{funcdesc}{atoi}{s\optional{\, base}} @@ -68,9 +69,11 @@ sign (\samp{+} or \samp{-}). The \var{base} defaults to 10. If it is 0, a default base is chosen depending on the leading characters of the string (after stripping the sign): \samp{0x} or \samp{0X} means 16, \samp{0} means 8, anything else means 10. If \var{base} is 16, a -leading \samp{0x} or \samp{0X} is always accepted. (Note: for a more -flexible interpretation of numeric literals, use the built-in function -\code{eval()}.) +leading \samp{0x} or \samp{0X} is always accepted. Note that when +invoked without \var{base} or with \var{base} set to 10, this behaves +identical to the built-in function \code{int()} when passed a string. +(Also note: for a more flexible interpretation of numeric literals, +use the built-in function \code{eval()}.) \bifuncindex{eval} \end{funcdesc} @@ -79,7 +82,9 @@ Convert string \var{s} to a long integer in the given \var{base}. The string must consist of one or more digits, optionally preceded by a sign (\samp{+} or \samp{-}). The \var{base} argument has the same meaning as for \code{atoi()}. A trailing \samp{l} or \samp{L} is not -allowed, except if the base is 0. +allowed, except if the base is 0. Note that when invoked without +\var{base} or with \var{base} set to 10, this behaves identical to the +built-in function \code{long()} when passed a string. \end{funcdesc} \begin{funcdesc}{capitalize}{word} @@ -227,17 +232,11 @@ 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} +\begin{funcdesc}{replace}{str, old, new\optional{, maxsplit}} 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). +\var{old} replaced by \var{new}. If the optional argument +\var{maxsplit} is given, the first \var{maxsplit} occurrences are +replaced. \end{funcdesc} This module is implemented in Python. Much of its functionality has