mindspore.Tensor.choose
=======================

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


.. py:method:: mindspore.Tensor.choose(choices, mode='clip')

    根据原始Tensor数组和一个索引数组构造一个新的Tensor。

    参数：
        - **choices** (Union[tuple, list, Tensor]) - 索引选择数组。原始输入Tensor和 `choices` 的广播维度必须相同。如果 `choices` 本身是一个Tensor，则其最外层的维度（即，对应于第零维的维度）被用来定义 `choices` 数组。
        - **mode** (str, 可选) - 指定如何处理 `[0, n-1]` 外部的索引。支持 ``'raise'`` 、 ``'wrap'`` 、 ``'clip'`` 。

          - ``raise`` ： 引发异常（默认）；
          - ``wrap`` ： 原值映射为对n取余后的值；
          - ``clip`` ： 大于n-1的值会被映射为n-1。该模式下禁用负数索引。

          默认值： ``'clip'`` 。

    返回：
        Tensor，合并后的结果。

    异常：
        - **ValueError** - 输入Tensor和任一 `choices` 无法广播。