From: Raymond Hettinger Date: Fri, 10 Apr 2009 04:27:37 +0000 (+0000) Subject: Clarify the table entries for combinatorics. X-Git-Tag: v3.1b1~328 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=175cb23bb9796cc2e0cfe6b33b3fa6c1b89c4912;p=python Clarify the table entries for combinatorics. --- diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst index 2cfc779ae5..68ce02cfa4 100644 --- a/Doc/library/itertools.rst +++ b/Doc/library/itertools.rst @@ -61,14 +61,19 @@ operator can be mapped across two vectors to form an efficient dot-product: **Combinatoric generators:** - ===================================== ==================== ================================================= - Iterator Arguments Results - ===================================== ==================== ================================================= - :func:`product` p, q, ... [repeat=1] cartesian product - :func:`permutations` p[, r] r-length permutations (without repeated elements) - :func:`combinations` p[, r] r-length combinations (sorted and no repeats) - :func:`combinations_with_replacement` p[, r] r-length combinations (sorted but with repeats) - ===================================== ==================== ================================================= + ============================================== ==================== ============================================================= + Iterator Arguments Results + ============================================== ==================== ============================================================= + :func:`product` p, q, ... [repeat=1] cartesian product, equivalent to a nested for-loop + :func:`permutations` p[, r] r-length tuples, all possible orderings, no repeated elements + :func:`combinations` p[, r] r-length tuples, in sorted order, no repeated elements + :func:`combinations_with_replacement` p[, r] r-length tuples, in sorted order, with repeated elements + | + ``product('ABCD', repeat=2)`` ``AA AB AC AD BA BB BC BD CA CB CC CD DA DB DC DD`` + ``permutations('ABCD', 2)`` ``AB AC AD BA BC BD CA CB CD DA DB DC`` + ``combinations('ABCD', 2)`` ``AB AC AD BC BD CD`` + ``combinations_with_replacement('ABCD', 2)`` ``AA AB AC AD BB BC BD CC CD DD`` + ============================================== ==================== ============================================================= .. _itertools-functions: