gh-133986: Document string split algorithm when sep is None and maxsplit is 0 (#133987)

* Document string split algorithm when sep is None and maxsplit is 0

* Update Doc/library/stdtypes.rst

Co-authored-by: Semyon Moroz <donbarbos@proton.me>

---------

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
Co-authored-by: Semyon Moroz <donbarbos@proton.me>
This commit is contained in:
Joey Smith 2025-05-14 04:17:26 -06:00 committed by GitHub
parent 6df39765e6
commit 3e23047363
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -2269,6 +2269,18 @@ expression support in the :mod:`re` module).
>>> ' 1 2 3 '.split()
['1', '2', '3']
If *sep* is not specified or is ``None`` and *maxsplit* is ``0``, only
leading runs of consecutive whitespace are considered.
For example::
>>> "".split(None, 0)
[]
>>> " ".split(None, 0)
[]
>>> " foo ".split(maxsplit=0)
['foo ']
.. index::
single: universal newlines; str.splitlines method