Commit add55441 authored by Raymond Hettinger's avatar Raymond Hettinger

Discussion of signatures for unicode.translate() and str.translate()

were in the wrong file.  Moved out of libstring.tex and into
libstdtypes.tex.
parent 7a9d76c3
...@@ -740,6 +740,16 @@ Return a copy of the string where all characters occurring in the ...@@ -740,6 +740,16 @@ Return a copy of the string where all characters occurring in the
optional argument \var{deletechars} are removed, and the remaining optional argument \var{deletechars} are removed, and the remaining
characters have been mapped through the given translation table, which characters have been mapped through the given translation table, which
must be a string of length 256. must be a string of length 256.
For Unicode objects, the \method{translate()} method does not
accept the optional \var{deletechars} argument. Instead, it
returns a copy of the \var{s} where all characters have been mapped
through the given translation table which must be a mapping of
Unicode ordinals to Unicode ordinals, Unicode strings or \code{None}.
Unmapped characters are left untouched. Characters mapped to \code{None}
are deleted. Note, a more flexible approach is to create a custom
character mapping codec using the \refmodule{codecs} module (see
\module{encodings.cp1251} for an example).
\end{methoddesc} \end{methoddesc}
\begin{methoddesc}[string]{upper}{} \begin{methoddesc}[string]{upper}{}
......
...@@ -277,16 +277,6 @@ parameter cannot be passed in earlier 2.2 versions]{2.2.3} ...@@ -277,16 +277,6 @@ parameter cannot be passed in earlier 2.2 versions]{2.2.3}
present), and then translate the characters using \var{table}, which present), and then translate the characters using \var{table}, which
must be a 256-character string giving the translation for each must be a 256-character string giving the translation for each
character value, indexed by its ordinal. character value, indexed by its ordinal.
For Unicode objects, the \method{translate()} method does not
accept the optional \var{deletechars} argument. Instead, it
returns a copy of the \var{s} where all characters have been mapped
through the given translation table which must be a mapping of
Unicode ordinals to Unicode ordinals, Unicode strings or \code{None}.
Unmapped characters are left untouched. Characters mapped to \code{None}
are deleted. Note, a more flexible approach is to create a custom
character mapping codec using the \refmodule{codecs} module (see
\module{encodings.cp1251} for an example).
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{upper}{s} \begin{funcdesc}{upper}{s}
......
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