Mercurial > cpython-lru_cache-weakref
diff Doc/lib/libstdtypes.tex @ 34491:68020bd1b9e2 2.4
SF bug #1105286: Undocumented implicit strip() in split(None) string method
Clarify the behavior when a string begins or ends with whitespace.
| author | Raymond Hettinger <python@rcn.com> |
|---|---|
| date | Tue, 25 Jan 2005 10:28:47 +0000 |
| parents | 67f2190e1f6d |
| children | 13176ed52e65 |
line wrap: on
line diff
--- a/Doc/lib/libstdtypes.tex Sun Jan 23 09:50:14 2005 +0000 +++ b/Doc/lib/libstdtypes.tex Tue Jan 25 10:28:47 2005 +0000 @@ -738,7 +738,9 @@ Return a list of the words in the string, using \var{sep} as the delimiter string. If \var{maxsplit} is given, at most \var{maxsplit} splits are done, the \emph{rightmost} ones. If \var{sep} is not specified -or \code{None}, any whitespace string is a separator. +or \code{None}, any whitespace string is a separator. Except for splitting +from the right, \method{rsplit()} behaves like \method{split()} which +is described in detail below. \versionadded{2.4} \end{methoddesc} @@ -765,11 +767,13 @@ separator returns an empty list. If \var{sep} is not specified or is \code{None}, a different splitting -algorithm is applied. Words are separated by arbitrary length strings of -whitespace characters (spaces, tabs, newlines, returns, and formfeeds). -Consecutive whitespace delimiters are treated as a single delimiter -(\samp{'1 2 3'.split()} returns \samp{['1', '2', '3']}). Splitting an -empty string returns \samp{['']}. +algorithm is applied. First, whitespace characters (spaces, tabs, +newlines, returns, and formfeeds) are stripped from both ends. Then, +words are separated by arbitrary length strings of whitespace +characters. Consecutive whitespace delimiters are treated as a single +delimiter (\samp{'1 2 3'.split()} returns \samp{['1', '2', '3']}). +Splitting an empty string or a string consisting of just whitespace +will return \samp{['']}. \end{methoddesc} \begin{methoddesc}[string]{splitlines}{\optional{keepends}}
