mirrors
/
cpython
mirror of https://github.com/python/cpython.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Document that encode() and decode() raise UnicodeError 

instead of ValueError.

Add a note about error handling schemes added by PEP 293.
This commit is contained in:
Walter Dörwald 2004-07-01 19:58:47 +00:00
parent ecf7a52bb8
commit ac1075a645
1 changed files with 10 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
Doc/lib/libstdtypes.tex
View File

@ -567,9 +567,11 @@ Decodes the string using the codec registered for \var{encoding}.
\var{encoding} defaults to the default string encoding. \var{errors} \var{encoding} defaults to the default string encoding. \var{errors}
may be given to set a different error handling scheme. The default is may be given to set a different error handling scheme. The default is
\code{'strict'}, meaning that encoding errors raise \code{'strict'}, meaning that encoding errors raise
\exception{ValueError}. Other possible values are \code{'ignore'} and \exception{UnicodeError}. Other possible values are \code{'ignore'},
\code{'replace'}. \code{'replace'} and any other name registered via
\function{codecs.register_error}.
\versionadded{2.2} \versionadded{2.2}
\versionchanged[Support for other error handling schemes added]{2.3}
\end{methoddesc} \end{methoddesc}
\begin{methoddesc}[string]{encode}{\optional{encoding\optional{,errors}}} \begin{methoddesc}[string]{encode}{\optional{encoding\optional{,errors}}}
@ -577,10 +579,13 @@ Return an encoded version of the string. Default encoding is the current
default string encoding. \var{errors} may be given to set a different default string encoding. \var{errors} may be given to set a different
error handling scheme. The default for \var{errors} is error handling scheme. The default for \var{errors} is
\code{'strict'}, meaning that encoding errors raise a \code{'strict'}, meaning that encoding errors raise a
\exception{ValueError}. Other possible values are \code{'ignore'} and \exception{UnicodeError}. Other possible values are \code{'ignore'},
\code{'replace'}. For a list of possible encodings, see \code{'replace'}, \code{'xmlcharrefreplace'}, \code{'backslashreplace'}
section~\ref{standard-encodings}. and any other name registered via \function{codecs.register_error}.
For a list of possible encodings, see section~\ref{standard-encodings}.
\versionadded{2.0} \versionadded{2.0}
\versionchanged[Support for \code{'xmlcharrefreplace'} and
\code{'backslashreplace'} and other error handling schemes added]{2.3}
\end{methoddesc} \end{methoddesc}
\begin{methoddesc}[string]{endswith}{suffix\optional{, start\optional{, end}}} \begin{methoddesc}[string]{endswith}{suffix\optional{, start\optional{, end}}}