---
source_url: https://docs.dolphindb.cn/zh/funcs/a/add.html
fetched_at: 2026-05-19T09:12:30Z
category: funcs
title: add
sha1: 80a9127a364af34ee86eaedf1edaf91da3bc039d
---

# 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**均为标量，则返回标量。

## 例子

```dolphindb
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 |

```dolphindb
x+1.5
```

| 0 | 1 |
| --- | --- |
| 2.5 | 5.5 |
| 3.5 | 6.5 |
| 4.5 | 7.5 |

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

| 0 | 1 |
| --- | --- |
| 5 | 8 |
| 6 | 9 |
| 7 | 10 |

```dolphindb
x+y
```

| 0 | 1 |
| --- | --- |
| 6 | 12 |
| 8 | 14 |
| 10 | 16 |

参见 ["+" 运算符](../../progr/operators/add.html)

相关函数：[sub](../s/sub.html)
