mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-27 02:39:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 13

#15554: clarify splitlines/split differences.

Browse source 
Patch by Chris Jerdonek.
This commit is contained in:
R David Murray 2012-08-06 16:09:09 -04:00
parent 670280470d
commit decdb74227
1 changed files with 8 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

13
Doc/library/stdtypes.rst
View file

@ -1183,16 +1183,19 @@ string 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]])