itertools.combinations()
itertools.combinations() is a Python function in the Itertools Module category. Returns all r-length unordered combinations without replacement. The syntax is itertools.combinations(iterable, r). Parameters: iterable, r. Returns: Iterator of tuples. A typical example: list(combinations([1,2,3], 2))
# [(1,2),(1,3),(2,3)]. A close sibling is itertools.chain(), which creates an iterator that returns elements from the first iterable until exhausted, then proceeds to the next. A close sibling is itertools.chain.from_iterable(), which alternative chain that takes a single iterable of iterables. A close sibling is itertools.product(), which cartesian product of input iterables (like nested for-loops). A close sibling is itertools.permutations(), which returns all possible r-length ordered arrangements of elements. More about this category: Iterator building blocks — chain, product, permutations, combinations, groupby. For a broader walkthrough, read the Itertools Module guide. Related Itertools Module entries: itertools.chain(), itertools.chain.from_iterable(), itertools.product(), itertools.permutations(), itertools.combinations_with_replacement(), itertools.cycle(). This page is part of the free Python Reference documentation covering 978+ functions, methods, and modules with examples and parameter details.