---
source_url: https://docs.dolphindb.cn/zh/funcs/f/file.html
fetched_at: 2026-05-19T09:21:38Z
category: funcs
title: file
sha1: bddc6d4032aad4a7668d8f3b8ddbf3d99feef252
---

# file

## 语法

`file(name, [mode="r"], [isLittleEndian])`

## 详情

file 函数通过给定的模式打开一个文件。该函数必须要用户登录后才能执行。

打开的模式可以是以下 6 种之一："r", "r+", "w", "w+", "a" 和 "a+"。默认的模式是 "r"
（只读）。[close](../c/close.html) 函数用于关闭一个打开的文件。

"r": 只读模式。游标位于文件头。

"r+": 读写模式。游标位于文件头。

"w": 只写模式，把文件清空。游标位于文件头。

"w+": 读写模式。如果文件不存在将创建文件，否则把文件清空。游标位于文件头。

"a":
追加模式（只写）。如果文件不存在将创建文件。游标位于文件尾，从文件尾开始写。连续地写文件，每次写完后，游标都会位于文件尾。

"a+":
追加模式（读写）。如果文件不存在将创建文件。游标位于文件尾，从文件尾开始读写。连续地写文件，每次写完后，游标都会位于文件尾。

## 参数

**name** 字符串，表示文件名称。

**mode** 字符串，表示打开的模式。

**isLittleEndian** 布尔值，表示是否采用小端模式。默认情况下，采用的是操作系统的大小端模式。它是一个可选参数。

## 返回值

一个句柄（HANDLE）。

## 例子

```dolphindb
fout=file("test.txt","w");
fout.writeLine("hello world!");
// output
1
fout.close();

fin = file("test.txt");
print fin.readLine();
// output
hello world!
fin.close();
```
