FP_SD_MOVE_FILE

移动SD卡上的文件

此FP指令将s1_FullFileNameSource指定的文件移动到s2_FullFileNameDestination指定的文件中。

参数

输入

s1_FullFileNameSource (STRING)

源文件和目录

s2_FullFileNameDestination (STRING)

目标文件和目录

s3_Format (WORD)

文件传输格式：

位0：

0：如果文件存在则覆盖
1：如果文件存在则异常结束

位1–15：为系统保留

标注

在SD存储卡指令的触发器EN变为TRUE后，SD存储访问活动标志（sys_bIsSDMemoryAccessActive）变为TRUE，并保持为TRUE直到执行完成。在此期间，无法执行其他SD存储卡指令。
如果s2_FullFileNameDestination指定的目录不存在，则发生错误3 "文件/目录名称错误"。
如果可用容量不足，则发生错误9 "SD卡已满"。
如果为s1_FullFileNameSource指定目录，为s2_FullFileNameDestination指定文件，则发生错误3 "文件/目录名称错误"。
如果目录由s1_FullFileNameSource指定，则此目录中的所有文件都被移动到s2_FullFileNameDestination指定的目录中。
不移动子目录。
移动后的写保护文件保持其状态。
SD卡上的可用容量必须大于要移动的文件。
如果由s1_FullFileNameSource指定文件，由s2_FullFileNameDestination指定目录，则文件被移动到目录中。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

如果使用索引寄存器指定的区域超出限制。

sys_bIsOperationErrorNonHold（对于一次扫描变为TRUE）

如果使用索引寄存器指定的区域超出限制。

示例

POU头

所有用于编程此函数的输入和输出变量已在POU头中声明。所有编程语言使用相同的POU头。

	VAR
		bStart: BOOL:=FALSE;
			(*activates the instruction*)
	END_VAR

POU本体

当变量bStart从FALSE变为 TRUE且系统变量sys_bIsSDMemoryAccessActive不是TRUE时，执行此函数。它将文件'TestString1.csv'从SD卡的根目录移动到目录'Test'中。

LD本体

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 6 ;
        NETWORK_BODY
B(B_VARIN,,'\TestString1.csv',21,2,23,4,);
B(B_VARIN,,'\Test\TestString1.csv',21,3,23,5,);
B(B_VARIN,,0,21,4,23,6,);
B(B_CONTACT,,bStart,3,1,5,3,R);
B(B_CONTACT,,sys_bIsSDMemoryAccessActive,11,1,13,3,N);
B(B_F,FP_SD_MOVE_FILE!,,23,0,37,6,,?DEN?Ds1_FullFileNameSource?Ds2_FullFileNameDestination?Ds3_Format?AENO);
L(1,2,3,2);
L(5,2,11,2);
L(13,2,23,2);
L(1,0,1,6);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

IF DF(bStart)AND not sys_bIsSDMemoryAccessActive then
    FP_SD_MOVE_FILE('\TestString1.csv', '\Test\TestString1.csv');
END_IF;