mindspore.nn.ZeroPad2d
======================

.. 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/nn/mindspore.nn.ZeroPad2d.rst
    :alt: 查看源文件


.. py:class:: mindspore.nn.ZeroPad2d(padding)

    将零填充到多维输入数据的最后两维。

    参数：
        - **padding** (Union[int, tuple]) - 对输入的最后两维进行填充的大小。如果padding的类型为int，则在输入最后两维的前后均填充 `padding` 大小，如果padding为长度为4的tuple，形如(padding_0, padding_1, padding_2, padding_3)，那么输入 `x` 对应输出的最后一维的shape为 :math:`padding\_0 + x.shape[-1] + padding\_1` ，输入 `x` 对应输出的倒数第二维的shape为 :math:`padding\_2 + x.shape[-2] + padding\_3` ，输出的其余维度与输入保持一致。在Ascend后端运行时，不支持 `padding` 包含负值情况。

    输入：
        - **x** (Tensor) - 输入Tensor，shape为 :math:`(N, *)`，其中 :math:`*` 表示任意维度。在Ascend后端运行时，不支持维度大于5。

    返回：
        Tensor，填充后的Tensor。

    异常：
        - **TypeError** - `padding` 既不是tuple或者int。
        - **ValueError** - tuple类型的padding长度大于4或者长度不是2的倍数。
        - **ValueError** - 填充后输出的维度不是正数。
        - **ValueError** - 在Ascend后端运行时，`x` 的维度大于5。
        - **ValueError** - 在Ascend后端运行时，`padding` 中包含负值。