Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

#15554: clarify splitlines/split differences. 

Patch by Chris Jerdonek.
This commit is contained in:
R David Murray 2012-08-06 16:08:09 -04:00
parent 9b000e7a68
commit 05c35a6a6b
1 changed files with 8 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
Doc/library/stdtypes.rst
View File

@ -1327,16 +1327,19 @@ functions based on regular expressions.
.. method:: str.splitlines([keepends]) .. method:: str.splitlines([keepends])
Return a list of the lines in the string, breaking at line boundaries. Line Return a list of the lines in the string, breaking at line boundaries.
breaks are not included in the resulting list unless *keepends* is given and This method uses the universal newlines approach to splitting lines.
true. This method uses the universal newlines approach to splitting lines. Line breaks are not included in the resulting list unless *keepends* is
Unlike :meth:`~str.split`, if the string ends with line boundary characters given and true.
the returned list does ``not`` have an empty last element.
For example, ``'ab c\n\nde fg\rkl\r\n'.splitlines()`` returns For example, ``'ab c\n\nde fg\rkl\r\n'.splitlines()`` returns
``['ab c', '', 'de fg', 'kl']``, while the same call with ``splitlines(True)`` ``['ab c', '', 'de fg', 'kl']``, while the same call with ``splitlines(True)``
returns ``['ab c\n', '\n, 'de fg\r', 'kl\r\n']``. returns ``['ab c\n', '\n, 'de fg\r', 'kl\r\n']``.
Unlike :meth:`~str.split` when a delimiter string *sep* is given, this
method returns an empty list for the empty string, and a terminal line
break does not result in an extra line.
.. method:: str.startswith(prefix[, start[, end]]) .. method:: str.startswith(prefix[, start[, end]])