PaddlePaddle · Ligoml · Aug 31, 2022 · Aug 19, 2022 · Aug 19, 2022 · Aug 26, 2022
diff --git a/docs/api/api_label b/docs/api/api_label
@@ -159,6 +159,7 @@ paddle.floor	.. _api_paddle_floor:
 paddle.Tensor.floor_	.. _api_paddle_Tensor_floor_:
 paddle.floor_divide	.. _api_paddle_floor_divide:
 paddle.mod	.. _api_paddle_mod:
+paddle.remainder	.. _cn_api_tensor_remainder:
 paddle.gather	.. _api_paddle_gather:
 paddle.gather_nd	.. _api_paddle_gather_nd:
 paddle.greater_equal	.. _api_paddle_greater_equal:

diff --git a/docs/api/paddle/Overview_cn.rst b/docs/api/paddle/Overview_cn.rst
@@ -115,6 +115,8 @@ tensor 数学操作
     " :ref:`paddle.stanh <cn_api_fluid_layers_stanh>` ", "stanh 激活函数"
     " :ref:`paddle.std <cn_api_tensor_cn_std>` ", "沿给定的轴 axis 计算 x 中元素的标准差"
     " :ref:`paddle.subtract <cn_api_paddle_tensor_subtract>` ", "逐元素相减算子"
+    " :ref:`paddle.remainder <cn_api_tensor_remainder>` ", "逐元素取模算子"
+    " :ref:`paddle.remainder_ <cn_api_tensor_remainder_>` ", "Inplace 版本的 remainder API，对输入 x 采用 Inplace 策略"
     " :ref:`paddle.sum <cn_api_tensor_sum>` ", "对指定维度上的 Tensor 元素进行求和运算"
     " :ref:`paddle.tan <cn_api_fluid_layers_tan>` ", "三角函数 tangent"
     " :ref:`paddle.tanh <cn_api_tensor_tanh>` ", "tanh 激活函数"

diff --git a/docs/api/paddle/Tensor_cn.rst b/docs/api/paddle/Tensor_cn.rst
@@ -1823,7 +1823,16 @@ remainder(y, name=None)
 
 返回类型：Tensor
 
-mod 函数的别名，请参考 :ref:`cn_api_tensor_mod`
+mod 函数的别名，请参考 :ref:`cn_api_tensor_remainder`
+
+remainder_(y, name=None)
+:::::::::
+
+返回：计算后的 Tensor
+
+返回类型：Tensor
+
+Inplace 版本的 :ref:`cn_api_tensor_remainder` API，对输入 `x` 采用 Inplace 策略。
 
 reshape(shape, name=None)
 :::::::::

diff --git a/docs/api/paddle/remainder__cn.rst b/docs/api/paddle/remainder__cn.rst
@@ -0,0 +1,8 @@
+.. _cn_api_tensor_remainder_:
+
+remainder
+-------------------------------
+
+.. py:function:: paddle.remainder(x, y, name=None)
+
+Inplace 版本的 :ref:`cn_api_tensor_remainder` API，对输入 `x` 采用 Inplace 策略。
diff --git a/docs/api/paddle/remainder_cn.rst b/docs/api/paddle/remainder_cn.rst
@@ -0,0 +1,29 @@
+.. _cn_api_tensor_remainder:
+
+remainder
+-------------------------------
+
+.. py:function:: paddle.remainder(x, y, name=None)
+
+逐元素取模算子。公式为：
+
+.. math::
+        out = x \% y
+
+**注意**:
+        ``paddle.remainder`` 支持广播。关于广播规则，请参考 :ref:`cn_user_guide_broadcasting`
+
+参数
+:::::::::
+        - x（Tensor）- 多维 Tensor。数据类型为 float32 、float64、int32 或 int64。
+        - y（Tensor）- 多维 Tensor。数据类型为 float32 、float64、int32 或 int64。
+        - name（str，可选）- 操作的名称(可选，默认值为 None）。更多信息请参见 :ref:`api_guide_Name`。
+
+返回
+:::::::::
+``Tensor``，存储运算后的结果。如果 x 和 y 有不同的 shape 且是可以广播的，返回 Tensor 的 shape 是 x 和 y 经过广播后的 shape。如果 x 和 y 有相同的 shape，返回 Tensor 的 shape 与 x，y 相同。
+
+代码示例
+:::::::::
+
+COPY-FROM: paddle.remainder