mindspore.ops.combinations
==========================

.. image:: https://mindspore-website.obs.cn-north-4.myhuaweicloud.com/website-images/r2.3.q1/resource/_static/logo_source.svg
    :target: https://gitee.com/mindspore/mindspore/blob/r2.3.q1/docs/api/api_python/ops/mindspore.ops.func_combinations.rst
    :alt: 查看源文件


.. py:function:: mindspore.ops.combinations(input, r=2, with_replacement=False)

    返回输入Tensor中元素的所有长度为 `r` 的子序列。

    当 `with_replacement` 设为 ``False`` ，功能与Python里的 `itertools.combinations` 类似，若设为 ``True`` ，功能与 `itertools.combinations_with_replacement` 一致。

    参数：
        - **input** (Tensor) - 一维Tensor。
        - **r** (int，可选) - 进行组合的元素个数。默认值： ``2`` 。
        - **with_replacement** (bool，可选) - 是否允许组合存在重复值。默认值： ``False`` 。

    返回：
        Tensor，包含输入Tensor元素的左右组合值。

    异常：
        - **TypeError** - 如果 `input` 不是Tensor。
        - **TypeError** - 如果 `r` 不是int类型。
        - **TypeError** - 如果 `with_replacement` 不是bool类型。
        - **ValueError** - 如果 `input` 不是一维。