【Hackathon 6th No.10】Add isin API to Paddle (#6661)

Author: NKNaN

docs/api/paddle/Overview_cn.rst

@@ -239,6 +239,7 @@ tensor 逻辑操作
     " :ref:`paddle.is_empty <cn_api_paddle_is_empty>` ", "测试变量是否为空"
     " :ref:`paddle.is_tensor <cn_api_paddle_is_tensor>` ", "用来测试输入对象是否是 paddle.Tensor"
     " :ref:`paddle.isfinite <cn_api_paddle_isfinite>` ", "返回输入 tensor 的每一个值是否为 Finite（既非 +/-INF 也非 +/-NaN ）"
+    " :ref:`paddle.isin <cn_api_paddle_isin>` ", "测试输入 x 的每一个值是否在 test_x 中"
     " :ref:`paddle.isinf <cn_api_paddle_isinf>` ", "返回输入 tensor 的每一个值是否为 +/-INF"
     " :ref:`paddle.isnan <cn_api_paddle_isnan>` ", "返回输入 tensor 的每一个值是否为 +/-NaN"
     " :ref:`paddle.isposinf <cn_api_paddle_isposinf>` ", "返回输入 tensor 的每一个值是否为 +INF"

docs/api/paddle/Tensor/Overview_en.rst

@@ -153,6 +153,7 @@ Methods
     is_empty
     is_tensor
     isfinite
+    isin
     isinf
     isnan
     isneginf

docs/api/paddle/Tensor_cn.rst

@@ -1479,6 +1479,15 @@ isfinite(name=None)
 
 请参考 :ref:`cn_api_paddle_isfinite`
 
+isin(test_x, assume_unique=False, invert=False, name=None)
+:::::::::
+
+返回：计算后的 Tensor
+
+返回类型：Tensor
+
+请参考 :ref:`cn_api_paddle_isin`
+
 isinf(name=None)
 :::::::::
 

docs/api/paddle/isin_cn.rst

@@ -0,0 +1,25 @@
+.. _cn_api_paddle_isin:
+
+isin
+-----------------------------
+
+.. py:function:: paddle.isin(x, test_x, assume_unique=False, invert=False, name=None)
+
+检验 ``x`` 中的每一个元素是否在 ``test_x`` 中。
+
+参数
+:::::::::
+    - **x** (Tensor) - 输入的 tensor，数据类型为：'bfloat16', 'float16', 'float32', 'float64', 'int32', 'int64'。
+    - **test_x** (Tensor) - 用于检验的 tensor，数据类型为：'bfloat16', 'float16', 'float32', 'float64', 'int32', 'int64'。
+    - **assume_unique** (bool，可选) - 如果设置为 True，表示 ``x`` 与 ``test_x`` 的元素均是唯一的，这种情况可以提升计算的速度。默认值为 False。
+    - **invert** (bool，可选) - 是否输出反转的结果。如果为 True，表示将结果反转。默认值为 False。
+    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+
+返回
+:::::::::
+``Tensor``，输出的 tensor 与输入 ``x`` 形状相同。
+
+代码示例
+:::::::::
+
+COPY-FROM: paddle.isin