(original) (raw)

changeset: 77288:24572015e24f branch: 3.2 parent: 77285:bf6305bce3af user: R David Murray rdmurray@bitdance.com date: Fri Jun 01 16:19:36 2012 -0400 files: Doc/library/stdtypes.rst description: #14957: clarify splitlines docs. Initial patch by Michael Driscoll, I added the example. diff -r bf6305bce3af -r 24572015e24f Doc/library/stdtypes.rst --- a/Doc/library/stdtypes.rst Fri Jun 01 20:23:20 2012 +0200 +++ b/Doc/library/stdtypes.rst Fri Jun 01 16:19:36 2012 -0400 @@ -1329,7 +1329,13 @@ Return a list of the lines in the string, breaking at line boundaries. Line breaks are not included in the resulting list unless *keepends* is given and - true. + true. This method uses the universal newlines approach to splitting lines. + Unlike :meth:`~str.split`, if the string ends with line boundary characters + the returned list does ``not`` have an empty last element. + + For example, ``'ab c\n\nde fg\rkl\r\n'.splitlines()`` returns + ``['ab c', '', 'de fg', 'kl']``, while the same call with ``splinelines(True)`` + returns ``['ab c\n', '\n, 'de fg\r', 'kl\r\n']``. .. method:: str.startswith(prefix[, start[, end]]) /rdmurray@bitdance.com