---
source_url: https://docs.dolphindb.cn/zh/funcs/w/writeLine.html
fetched_at: 2026-05-19T09:44:09Z
category: funcs
title: writeLine
sha1: d173f1da25f75cec6e56de98df09a0c41cc0902a
---

# writeLine

## 语法

`writeLine(handle, string,
[windowsLineEnding])`

## 详情

在给定的句柄中写一行。函数自动将一个行分隔符添加到字符串结尾。所以字符串不应该以行分隔符结尾。如果该操作成功，函数返回
1；否则，将抛出一个 IOException。

## 参数

**handle** 句柄，指向目标文件或套接字的对象。

**string** 字符串，表示要写入的一行文本，末尾不需要加换行符。

**windowsLineEnding**可选参数，布尔值，用于指定是否强制使用 Windows 风格的换行符（
\r\n）。如果未指定该参数，换行符的默认行为如下：

- 如果句柄是一个套接字，行结束符是 \r\n
- 如果句柄是一个文件，且操作系统不是 Windows，行结束符是 \n
- 如果句柄是一个文件，且操作系统是 Windows，行结束符是 \r\n

## 返回值

数字 1。

## 例子

```dolphindb
x=`IBM`MSFT`GOOG`YHOO`ORCL
eachRight(writeLine, file("test.txt","w"), x);
// output
[1,1,1,1,1]

fin = file("test.txt")
do{
   x=fin.readLine()
   if(x.isVoid()) break
   print x
}
while(true);

// output
IBM
MSFT
GOOG
YHOO
ORCL
```
