changeset: 85637:23f77dc58979 branch: 3.3 parent: 85634:29fa1f418796 user: Raymond Hettinger date: Mon Sep 09 02:01:35 2013 -0500 files: Doc/library/itertools.rst Modules/itertoolsmodule.c description: Issue 18752: Make chain.from_iterable() more visible in the documentation. diff -r 29fa1f418796 -r 23f77dc58979 Doc/library/itertools.rst --- a/Doc/library/itertools.rst Mon Sep 09 01:54:27 2013 -0500 +++ b/Doc/library/itertools.rst Mon Sep 09 02:01:35 2013 -0500 @@ -48,6 +48,7 @@ ==================== ============================ ================================================= ============================================================= :func:`accumulate` p [,func] p0, p0+p1, p0+p1+p2, ... ``accumulate([1,2,3,4,5]) --> 1 3 6 10 15`` :func:`chain` p, q, ... p0, p1, ... plast, q0, q1, ... ``chain('ABC', 'DEF') --> A B C D E F`` +chain.from_iterable iterable p0, p1, ... plast, q0, q1, ... ``chain.from_iterable(['ABC', 'DEF']) --> A B C D E F`` :func:`compress` data, selectors (d[0] if s[0]), (d[1] if s[1]), ... ``compress('ABCDEF', [1,0,1,0,1,1]) --> A C E F`` :func:`dropwhile` pred, seq seq[n], seq[n+1], starting when pred fails ``dropwhile(lambda x: x<5, [1,4,6,4,1]) --> 6 4 1`` :func:`filterfalse` pred, seq elements of seq where pred(elem) is False ``filterfalse(lambda x: x%2, range(10)) --> 0 2 4 6 8`` diff -r 29fa1f418796 -r 23f77dc58979 Modules/itertoolsmodule.c --- a/Modules/itertoolsmodule.c Mon Sep 09 01:54:27 2013 -0500 +++ b/Modules/itertoolsmodule.c Mon Sep 09 02:01:35 2013 -0500 @@ -4,7 +4,7 @@ /* Itertools module written and maintained by Raymond D. Hettinger - Copyright (c) 2003 Python Software Foundation. + Copyright (c) 2003-2013 Python Software Foundation. All rights reserved. */ @@ -4456,6 +4456,7 @@ Iterators terminating on the shortest input sequence:\n\ accumulate(p[, func]) --> p0, p0+p1, p0+p1+p2\n\ chain(p, q, ...) --> p0, p1, ... plast, q0, q1, ... \n\ +chain.from_iterable([p, q, ...]) --> p0, p1, ... plast, q0, q1, ... \n\ compress(data, selectors) --> (d[0] if s[0]), (d[1] if s[1]), ...\n\ dropwhile(pred, seq) --> seq[n], seq[n+1], starting when pred fails\n\ groupby(iterable[, keyfunc]) --> sub-iterators grouped by value of keyfunc(v)\n\