功能块 FS_WRITE

功能块 FS_WRITE 将数据写入文件系统。

注意: 已经存在的文件会在没有警告的情况下被覆盖。

文件系统必须先通过 FS_INIT 初始化。所有操作都是异步进行,每个创建的存储介质执行一次。

输入 WRITE

在正边沿时,数据将被写入存储介质。

输入 DEV

定义要访问文件的设备。该设备在项目中使用,并可以在上下文菜单中通过 项目 外部存储 进行管理。

输入 PATH

指定存储介质上的文件路径。如果支持,该路径对应于 UTF-8 格式的 Unix 文件路径。路径如下所示:

Folder/Subfolder/File.txt

输入 DATA

定义要写入的数据。

输入 MODE

指定要写入文件的模式。可能的模式如下:

模式 描述
"r" 仅用于读取。将文件指针放在文件开头。
"r+" 仅用于读取和写入。将文件指针放在文件开头。
"w" 仅用于写入。将文件指针放在文件开头。删除文件内容。如果文件不存在,则创建该文件。
"w+" 仅用于写入和读取。将文件指针放在文件开头。删除文件内容。如果文件不存在,则创建该文件。
"a" 仅用于写入。将文件指针放在文件末尾。如果文件不存在,则创建该文件。数据将附加到末尾。
"a+" 仅用于写入和读取。将文件指针放在文件末尾。如果文件不存在,则创建该文件。数据将附加到末尾。
"x" 仅用于写入。将文件指针放在文件开头。如果文件存在,则中止。
"x+" 仅用于写入和读取。将文件指针放在文件开头。如果文件存在,则中止。
"c" 仅用于写入。将文件指针放在文件开头。如果文件不存在,则创建该文件。覆盖文件内容。
"c+" 仅用于写入和读取。将文件指针放在文件开头。如果文件不存在,则创建该文件。覆盖文件内容。

输入 BOM

如果写入时输入为真,则将 UTF-8 字节顺序标记添加到文件开头。这仅在覆盖或创建新文件时发生。如果未在文件开头写入 BOM,则无法事后添加。

输出 DONE

输出在成功时返回一个脉冲,以执行下一个操作。该脉冲在操作结束时发生,即使发生了错误。

输出 LENGTH

返回写入的字节数。状态将被保存以供后续使用。

输出 ERROR

在出错情况下,返回包含错误消息的文本。如果没有发生错误,则为 FALSE。状态将被保存以供后续使用。

可能的原因:

  • 未启动存储介质服务。
  • 未初始化存储器。
  • 登录数据无效。
  • 无法访问远程服务器。
  • 不存在存储介质。
  • 指定的路径无效。
  • 无法写入存储介质。
  • 存储器上没有可用空间或存储器已写保护。