• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1mindspore.ops.ListDiff
2======================
3
4.. py:class:: mindspore.ops.ListDiff(out_idx=mstype.int32)
5
6    比较两个数字列表之间的不同。
7
8    给定一个列表 `x` 和一个列表 `y`，此操作返回一个列表 `out`，表示在 `x` 中但不在 `y` 中的所有值。
9    返回列表 `out` 的排序顺序与数字出现在 `x` 中的顺序相同（保留重复项）。此操作还会返回一个列表 `idx` ，
10    表示每个 `out` 元素在 `x` 中的位置。即： :code:`out[i] = x[idx[i]] for i in [0, 1, ..., len(out) - 1]` 。
11
12    参数：
13        - **out_idx** (:class:`mindspore.dtype`，可选) - `idx` 的数据类型，可选值： ``mstype.int32`` 和 ``mstype.int64`` 。默认值： ``mstype.int32`` 。
14
15    输入：
16        - **x** (Tensor) - 保留的值。是一个1D Tensor。
17        - **y** (Tensor) - 需要被删除的值。是一个1D Tensor，与 `x` 类型一致。
18
19    输出：
20        - **out** (Tensor) - 被保留下来的值。是一个1D Tensor，与 `x` 类型一致。
21        - **idx** (Tensor) - 被保留值的原始索引。是一个1D Tensor， 类型由 `out_idx` 指定。
22
23    异常：
24        - **ValueError** - 如果 `x` 或 `y` 的shape不是1D。
25        - **TypeError** - 如果 `x` 或 `y` 不是Tensor。
26        - **TypeError** - 如果 `x` 或 `y` 的数据类型不是int或者uint。
27        - **TypeError** - 如果 `x` 与 `y` 的数据类型不同。
28        - **TypeError** - 如果属性 `out_idx` 的取值不在[mstype.int32, mstype.int64]中。
29