---
source_url: https://docs.dolphindb.cn/zh/funcs/n/neg.html
fetched_at: 2026-05-19T09:33:11Z
category: funcs
title: neg
sha1: 1a759b061916b5b6483e95212bca803e1eedf18e
---

# neg

## 语法

`neg(X)` 或 `neg X`

## 详情

返回 *X* 的相反数。

neg 函数和运算符 - 在大部分场景下可以相互替代，但仍然存在一些区别：

- neg 与括号结合时，被当作函数处理，具有最高优先级；
- neg 不与括号结合时，则优先级较低，会先运算 neg 右边的表达式，再运算 neg。例如：neg 3 + 5，结果为 -8。
- 运算符 "-" 则总是按照运算符优先级执行。例如：-3 + 5，结果为 2。

## 参数

**X** 可以是标量、数据对、向量或矩阵。

## 返回值

返回一个与输入 *X* 相同数据类型和形式的对象。

## 例子

```dolphindb
x=1:2;
-x;
// output
-1 : -2
```

```dolphindb
x=1 0 1;
-x;
// output
[-1,0,-1]
```

```dolphindb
m=1 1 1 0 0 0 $ 2:3;
m;
```

| #0 | #1 | #2 |
| --- | --- | --- |
| 1 | 1 | 0 |
| 1 | 0 | 0 |

```dolphindb
-m
```

| #0 | #1 | #2 |
| --- | --- | --- |
| -1 | -1 | 0 |
| -1 | 0 | 0 |
