读取文件节点
概述
Read File节点用于从文件系统中读取指定文件的内容，并将其作为字符串输出。
如果您正在使用Rivet SDK，此节点要求在运行图时上下文中有一个可用的原生API。该原生API负责提供读取目录内容的功能。
- 输入
- 输出
- 编辑器设置
输入项
| 标题 | 数据类型 | 描述 | 默认值 | 备注 |
|---|---|---|---|---|
| Path | string | The path of the file to read. This input is only available if Use Path Input is enabled in settings. | N/A | The input will be coerced into a string if it is not a string. |
输出
| 标题 | 数据类型 | 描述 | 备注 |
|---|---|---|---|
| Content | string | The contents of the file read from the specified path. | If the file does not exist and Error On Missing File is disabled, this output will be an empty string. |
编辑器设置
| 设置 | 描述 | 默认值 | 使用输入切换 | 输入数据类型 |
|---|---|---|---|---|
| Path | The path of the file to read. | (required) | Yes | string |
| 使用路径输入 | 如果启用，可以通过路径输入端口提供路径。 | False | No | N/A |
| 文件缺失时报错 | 如果启用此选项，当文件不存在时节点将报错。如果禁用此选项，当文件不存在时节点将输出空字符串。 | False | No | N/A |
示例1：从指定路径读取文件
- 创建一个Read File节点，并将
Path设置为要读取文件的路径。 - 运行图表。Read File节点的
Content输出应包含文件内容。
示例2：从动态路径读取文件
- 创建一个Text Node并将文本设置为要读取的文件路径。
- 创建一个读取文件节点并启用
Use Path Input设置。 - 将文本节点连接到读取文件节点的
Path输入端口。 - 运行图形。Read File节点的
Content输出应包含文件内容。
错误处理
如果在运行图形时原生API不可用，Read File节点将会报错。如果文件不存在且启用了Error On Missing File设置，它也会报错。如果文件不存在且禁用了Error On Missing File设置，该节点将输出一个空字符串。
常见问题
问：什么是原生API？
A: 原生API是一个负责为节点提供原生功能的对象。它在图运行时被传递给上下文。原生API必须实现NativeApi接口，该接口包含读取目录、读写文件以及其他原生操作的方法。更多信息请参阅API参考文档。
问：我可以从URL读取文件吗？
A: 不，Read File节点只能从本地文件系统读取文件。如果您想从URL读取文件，可以使用HTTP Call Node向该URL发出GET请求。
问：我可以读取不同格式的文件吗，比如CSV或XML？
A: 读取文件节点始终会将文件内容作为字符串输出。如果您想解析文件内容，可以使用其他节点，如Extract JSON、Extract YAML和Code Node来解析文件内容。