From: Raymond Hettinger <rhettinger@users.noreply.github.com>
Date: Wed, 2 Feb 2022 04:18:52 +0000 (-0600)
Subject: Add recipe for subslices (GH-31028)
X-Git-Tag: v3.11.0a5~23
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=06a491179f2de106d34c6b4973a32dce08fc4247;p=thirdparty%2FPython%2Fcpython.git

Add recipe for subslices (GH-31028)
---

diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst
index f0d93ebb6b21..8c3b7842f7f6 100644
--- a/Doc/library/itertools.rst
+++ b/Doc/library/itertools.rst
@@ -893,6 +893,12 @@ which incur interpreter overhead.
            yield from it
        return true_iterator(), remainder_iterator()
 
+   def subslices(seq):
+       "Return all contiguous non-empty subslices of a sequence"
+       # subslices('ABCD') --> A AB ABC ABCD B BC BCD C CD D
+       slices = starmap(slice, combinations(range(len(seq) + 1), 2))
+       return map(operator.getitem, repeat(seq), slices)
+
    def powerset(iterable):
        "powerset([1,2,3]) --> () (1,) (2,) (3,) (1,2) (1,3) (2,3) (1,2,3)"
        s = list(iterable)
@@ -1188,6 +1194,9 @@ which incur interpreter overhead.
     >>> ''.join(remainder)
     'dEfGhI'
 
+    >>> list(subslices('ABCD'))
+    ['A', 'AB', 'ABC', 'ABCD', 'B', 'BC', 'BCD', 'C', 'CD', 'D']
+
     >>> list(powerset([1,2,3]))
     [(), (1,), (2,), (3,), (1, 2), (1, 3), (2, 3), (1, 2, 3)]