> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# messageReadLine

> 从当前消息中读取一行内容，支持指定行号和编码。

逐行读取和枚举消息项的内容，并从消息中逐行返回。

## 可选的参数

* **separator**：决定每一行的分隔符。默认值是换行符（`\n`）。
* **encoding**：用于将消息数据解码为字符串的编码。允许的值由所使用的 JVM/OS 决定。大多数操作系统和 JVM 通常支持的编码值包括`UTF-8`、`ASCII`、`BASE64`、`Hex`、`windows-1252`和`ISO-8859-2`。默认值为 `UTF-8`。

## 输出属性

* **line**: 从消息中推送出去的数据的行号。
* **data**：消息中的行数据。

## 示例

### 仅将第一行的 ABC 替换为 DEF

```xml theme={null}
<!-- Initializing the item to hold the message data minus the first line -->
<arc:set attr="restof.data" value="" />
<!-- Calling the messageReadLine operation and setting the output item -->
<arc:call op="messageReadLine" out="result" >
  <!-- Once the operation gets to the first line in the message data, perform a replace -->
  <arc:if exp="[result.line] == 1">
    <arc:set attr="first.line" value="[result.data | replace('Owen','Liu')]" />
    <arc:else>
      <!-- Setting the data for the output message to be the concatenation of the modified first line and the rest of the message data -->
      <arc:set attr="output.data" value="[first.line][restof.data]\n[result.data]" />
    </arc:else>
  </arc:if> 
</arc:call>
<arc:set attr="output.filepath" value="[FilePath]" />
<arc:push item="output" />
```