changeset: 77289:2a43088318ed
parent: 77287:d7c4089e9637
parent: 77288:24572015e24f
user: R David Murray <rdmurray@bitdance.com>
date: Fri Jun 01 16:20:26 2012 -0400
files: Doc/library/stdtypes.rst
description:
#14957: clarify splitlines docs.
Initial patch by Michael Driscoll, I added the example.
diff -r d7c4089e9637 -r 2a43088318ed Doc/library/stdtypes.rst
--- a/Doc/library/stdtypes.rst	Fri Jun 01 20:25:36 2012 +0200
+++ b/Doc/library/stdtypes.rst	Fri Jun 01 16:20:26 2012 -0400
@@ -1353,7 +1353,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]])
</div><div class="naked_ctrl">
<form action="/index.cgi/contrast" method="get" name="gate">
<p><a href="http://altstyle.alfasado.net">AltStyle</a> によって変換されたページ <a href="https://hg.python.org/cpython/rev/2a43088318ed">(-&gt;オリジナル)</a>
/ <label>アドレス: <input type="text" name="naked_post_url" value="https://hg.python.org/cpython/rev/2a43088318ed" size="22" /></label> <label>モード: <select name="naked_post_mode">
<option value="default">デフォルト</option>
<option value="speech">音声ブラウザ</option>
<option value="ruby">ルビ付き</option>
<option value="contrast" selected="selected">配色反転</option>
<option value="larger-text">文字拡大</option>
<option value="mobile">モバイル</option>
</select>
<input type="submit" value="表示" />
</p>
</form>
</div>