---
source_url: https://docs.dolphindb.cn/zh/funcs/f/first.html
fetched_at: 2026-05-19T09:21:43Z
category: funcs
title: first
sha1: 65ba828ce036b5e232f1f4f2a96846570bd2dc91
---

# first

## 语法

`first(X)`

或

`first X`

## 详情

返回向量的第一个元素，或矩阵、表的第一行。

注：

若向量的第一个元素为 NULL，则返回 NULL。若要返回第一个非 NULL 的元素，请使用 [firstNot](firstNot.html) 函数。

## 参数

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

## 返回值

一个标量或向量，其数据类型同 *X*。

## 例子

```dolphindb
first(`hello `world);
```

输出返回：hello

```dolphindb
first(1..10);
```

输出返回：1

```dolphindb
m = matrix(1 2 3, 4 5 6);
m;
```

输出返回：

| #0 | #1 |
| --- | --- |
| 1 | 4 |
| 2 | 5 |
| 3 | 6 |

```dolphindb
first(m);
```

输出返回：[1,4]

相关函数：[last](../l/last.html)
