add

语法

add(X, Y)

详情

对 X 和 Y 内的元素逐个求和并返回。

DolphinDB add 函数与 numpy add、pandas Series.add / DataFrame.add 的功能与实现对比：


对比维度	DolphinDB `add`	`numpy.add`	pandas `add`
功能核心	支持标量、向量、矩阵等数据的逐元素加法	支持标量、ndarray，遵循 NumPy 广播规则	按索引对齐加法，支持广播标量
索引对齐	索引序列和索引矩阵可按索引对齐	不支持	可指定按索引或列对齐
空值处理	NULL 值传播（NULL + 任何值 = NULL）；可结合 `withNullFill` 指定填充值	NaN 传播（NaN + 任何数 = NaN）	自动处理，可通过 fill_value 指定填充值

参数

X 和 Y 可以是标量、数据对、向量或矩阵。如果 X 和 Y 中其中一个是数据对、向量或矩阵，另一个参数的长度或维度必须相同。

返回值

若X 和 Y至少一个是矩阵，则返回矩阵；否则，若至少一个是数据对，则返回数据对;否则，若至少有一个是向量，则返回向量;若X 和 Y均为标量，则返回标量。

例子

add(3,2)
// output
5

1:2+6
// output
7:8

1:2+3:4
// output
4 : 6

3+1..3
// output
[4,5,6]

add(1..3, 4..6)
// output
[5,7,9]

(1..3).add(4..6)
// output
[5,7,9]

x=reshape(1..6, 3:2)
x


0	1
1	4
2	5
3	6

x+1.5


0	1
2.5	5.5
3.5	6.5
4.5	7.5

y=reshape(5..10, 3:2)
y


0	1
5	8
6	9
7	10

x+y


0	1
6	12
8	14
10	16

参见 "+" 运算符