mindspore.ops.select
====================

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


.. py:function:: mindspore.ops.select(cond, x, y)

    根据条件判断Tensor中的元素的值，来决定输出中的相应元素是从 `x` （如果元素值为True）还是从 `y` （如果元素值为False）中选择。

    该算法可以被定义为：

    .. math::

        out_i = \begin{cases}
        x_i, & \text{if } cond_i \\
        y_i, & \text{otherwise}
        \end{cases}

    参数：
        - **cond** (Tensor[bool]) - 条件Tensor，决定选择哪一个元素，shape是 :math:`(x_1, x_2, ..., x_N, ..., x_R)`。
        - **x** (Union[Tensor, int, float]) - 第一个被选择的Tensor或者数字。
          如果x是一个Tensor，那么shape是或者可以被广播为 :math:`(x_1, x_2, ..., x_N, ..., x_R)`。
          如果x是int或者float，那么将会被转化为int32或者float32类型，并且被广播为与y相同的shape。x和y中至少要有一个Tensor。
        - **y** (Union[Tensor, int, float]) - 第二个被选择的Tensor或者数字。
          如果y是一个Tensor，那么shape是或者可以被广播为 :math:`(x_1, x_2, ..., x_N, ..., x_R)`。
          如果y是int或者float，那么将会被转化为int32或者float32类型，并且被广播为与x相同的shape。x和y中至少要有一个Tensor。

    返回：
        Tensor，与 `cond` 的shape相同。

    异常：
        - **TypeError** - `x` 和 `y` 不是Tensor、int或者float。
        - **ValueError** - 输入的shape不能被广播。