摘要
可以选择如下三种模式的任意一种：“新建”、“添加”或“覆盖”。有关数据存储顺序的更多信息，请参阅下面的“数据存储模式”一节。
格式
_CF_write/_USB_write (文件夹名称、文件名、从地址中读取、偏移、字节数、模式)
参数1
文件夹名称：固定字符串(最大长度：32个单字节字符)
参数2
文件名称：固定字符串(最大长度：32个单字节字符)、内部寄存器(最大长度：14个单字节字符)、用偏移量指定的内部寄存器(内部寄存器 +临时地址，最大长度：14个单字节字符)
参数3
读取源地址：寄存器地址、寄存器地址 + 临时地址
参数4
偏移：数值、寄存器地址、临时地址(可以指定的最大数量：16位长度为65,535，32位长度为4,294,967,295)
参数5
字节数：数值、寄存器地址、临时地址(最大长度：1280)
参数6
模式：数值、寄存器地址、临时地址(可用值：0, 1, 2)
存储格式概述
|
模式 |
名称 |
描述 |
|
0 |
新建 |
创建一个新文件。如果存在一个具有相同名称的文件，它将被删除。 |
|
1 |
添加 |
向指定文件添加数据。如果指定文件不存在，将会创建一个新文件。 |
|
2 |
覆盖 |
覆盖部分文件。如果指定偏移大于文件大小，将用0填充剩余区域，并将数据写入该区的后面。如果将偏移指定为文件数据的末尾，就相当于向文件添加数据。如果文件不存在，则会发生错误。有关该错误的更多信息，请参阅22.11.6.7 标签设置。 |
表达式示例：
[w:[#INTERNAL]LS0200] = 0//偏移量(当模式为“新建”时为“0”)
[w:[#INTERNAL]LS0202] = 100 //字节数(100字节)。
[w:[#INTERNAL]LS0204] = 0 //模式(新建)。
_CF_write ("\DATA", "DATA0001.BIN", [w:[#INTERNAL]LS0100], [w:[#INTERNAL]LS0200],[w:[#INTERNAL]LS0202], [w:[#INTERNAL]:LS0204])
上例中，从LS0100中读取100字节的数据，以DATA0001.BIN为名保存在\DATA文件夹中。可以通过定义内部寄存器的偏移、字节数和模式间接定义字节数和模式。
用一个内部寄存器定义文件名
_CF_write ("\DATA", [w:[#INTERNAL]LS0100], [w:[#INTERNAL]LS0200], 0, 100, 0)
通过将文件名保存在LS0100中，可间接指定文件名。在本例中，按如下方式将文件名保存在LS0100至LS0106中。
在上例中，从LS0200中读取100字节的数据，并创建新文件("\DATA\DATA0001.BIN")，以保存数据。
文件名只能使用8.3格式(最大12个字符，其中8个字符用于文件名、点号，3个字符用于扩展名)。不能使用长度大于12个字符的文件名。
参数1文件夹名称的最大长度是32个单字节字符。
文件夹名称可以附加到参数2文件名。参数2文件夹名称的最大长度+文件名是32个单字节字符。
例如，\DATA\01\DATA.bin
可以为第二个参数(文件名)指定内部寄存器。指定内部寄存器可允许文件名间接地址指定。此外，使用内部寄存器时，文件夹名称+文件名的最大长度为14个单字节字符。
偏移设置只在“覆盖”模式下有效。在“新建”和“添加”模式下禁用偏移设置。在非“覆盖”模式下将偏移值设置为“0”。
当指定“新建”模式且已经存在一个具有相同文件名的文件时，它会被覆盖。
当为“文件名”指定LS区时，“读取源地址”不被作为D脚本地址。
当为“读取源地址”指定PLC时，函数执行时仅从PLC中读取一次数据。如果数据读取过程中发生错误，它会导致CF卡或USB存储器读取错误：[s:CF_ERR_STAT]或[s:USB_ERR_STAT]。当成功完成数据读取时该错误被清除。
数据被分成若干项目并从源地址中被读取，尽管这取决于要读取的字节数。因此，即便是数据读取过程中发生了通讯故障，仍可能已将数据部分地写入到了指定文件。
要为文件名指定完整路径，请将文件夹名称指定为“*”(星号)。
例如，_CF_read ("*", "\DATA\DATA0001.BIN", [w:[#INTERNAL]LS0100], 0, 10)
存储格式表达式示例
当指定“新建”模式时
在上例中，从LS0100中读取100字节的数据，DATA0001.BIN文件刚在\DATA文件夹中创建。
当指定“附加”模式时
如果指定文件(如例子中的DATA0001.BIN)已经存在且执行了上面的语句，会从LS0100和之后区域中读取100个字节的数据并将其写入\DATA文件夹中的DATA0001.BIN文件。
当指定“覆盖”模式时(1)
如果指定文件(如例子中的DATA0001.BIN)已经存在且执行了上面的语句，就会读取保存在LS0100和之后区域的10个字节的数据，并覆盖保存在\DATA文件夹下DATA0001.BIN文件中的偏移之后第17个及之后的10个字节的数据。
当指定“覆盖”模式时(2)
(将被覆盖的文件小于偏移值和增加字节数总和。)
指定文件(如例子中的DATA0001.BIN)已经存在且文件大小是100字节。如果为覆盖操作将偏移设置为96字节，字节数设置为10字节，会读取保存在LS0100及之后区域中的10字节数据。然后，前4个字节的已读取数据会覆盖保存在文件中的第97个及之后的4字节数据，剩余的6字节数据被添加到文件数据的末尾。最终文件就包含了106字节的数据。
当指定“覆盖”模式时(3)
(要覆盖的文件小于偏移值。)
指定文件(如例子中的DATA0001.BIN)已经存在且文件大小是100字节。如果为覆盖操作将偏移设置为110字节，字节数设置为10字节，则会用0填充第101字节和第110字节之间的区域，从LS0100及之后区域中读取的10字节数据会被写入第111字节及之后的字节中。最终文件就包含了120字节的数据。