关于pad这个api文档使用说明

[leftsl]

文档链接&描述 Document Links & Description

有问题的链接

**存在的问题：**原文中说 当 mode 为 'constant' 时， pad 的长度可以是任意小于等于 2*N 的偶数。但是经过我的实际测试，不是偶数，比如NCL格式，我的pad长度为3也可以，如果超出规定最大长度，并不会报错，只不过不起作用，这点paddle做得很好。

请提出你的建议/提个PR修复这个问题 Please give your suggestion/update a PR to fix it

**对应的建议：**偶数去掉，paddle很厉害了现在，不是偶数也能照样填充。

[Echo-Nie]

刚才测试了一下pad函数，和您说的差不多，好像奇数的填充方式和偶数不一样（？），一会提交PR进行反馈~

[leftsl]

感谢，回复非常快速，感谢paddle团队认可我这个小提议😊

[Echo-Nie]

关于pad函数的问题可以参考这个PR描述：#7300
pad函数实际上是针对偶数进行设计的，如果输入奇数长度的话会自动补0变成偶数长度，之后按照偶数长度来处理。

关于奇数的解释

假如输入 pad=[1, 2, 3] ，一个长度为 3 的奇数列表，框架会自动补零变成 [1, 2, 3, 0]，按二维填充规则如下：**

• 左边填充 1，
• 右边填充 2，
• 上边填充 3，
• 下边填充 0。

现在 pad = [1, 2, 3, 0]，可以从左到右两两分组：

维度	前填充	后填充
宽度（左右）	1（左）	2（右）
高度（上下）	3（上）	0（下）

所以就是：

• 图像左边加 1 列；
• 图像右边加 2 列；
• 图像上边加 3 行；
• 图像下边不加；

测试代码

import paddle
import paddle.nn.functional as f

# 创建一个形状 [1, 1, 2, 3] 的张量（N=1, C=1, H=2, W=3）
x = paddle.to_tensor([[[[1, 2, 3],
                        [4, 5, 6]]]], dtype='float32')

# 使用 pad=[1,2,3]，被处理成 pad=[1,2,3,0]
pad = [1, 2, 3]
y = f.pad(x=x,pad=pad, mode='constant', value=0)

print(y.shape)  # 输出: [1, 1, 5, 6]
print(y.numpy())

输出说明

原始大小是 2x3。
宽度方向（W）：

• 左填 1 → 增加 1 列；
• 右填 2 → 增加 2 列；
  新宽度 = 3 + 1 + 2 = 6；

高度方向（H）：

• 上填 3 → 增加 3 行；
• 下填 0 → 不增加；
  新高度 = 2 + 3 = 5；

所以输出形状为 [1, 1, 5, 6]。

感谢您提出的问题 👍~ 目前文档也会进行相应的更新，如下~

谢谢您的支持！

[leftsl]

感谢感谢，解释得十分详细，多谢大佬，祝paddle越来越好

[Echo-Nie]

@luotao1 the issue can be closed due to the PR merged :

• Fix PaddleDocs function pad  #7300