From bd3add06f6685502da78c52d0bee5b04ca708425 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Thu, 15 May 2025 03:33:38 +0200 Subject: [PATCH] [3.13] gh-133986: Document string split algorithm when sep is None and maxsplit is 0 (GH-133987) (#133992) gh-133986: Document string split algorithm when sep is None and maxsplit is 0 (GH-133987) --------- (cherry picked from commit 3e23047363f384b7254b7af51afe4e353be94167) Co-authored-by: Joey Smith Co-authored-by: Ned Batchelder Co-authored-by: Semyon Moroz --- Doc/library/stdtypes.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index 0936be0caaf..ccaa0efaada 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -2133,6 +2133,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