FP_SD_RENAME_FILE

重命名SD卡上的文件

此FP指令将s1_FullFileNameOld指定的文件重命名为s2_FullFileNameNew指定的新文件名。

参数

输入

s1_FullFileNameOld (STRING): 旧文件名
s2_FullFileNameNew (STRING): 新文件名

标注

也请参阅有关SD卡访问的注意事项。
在SD存储卡指令的触发器EN变为TRUE后，SD存储访问活动标志（sys_bIsSDMemoryAccessActive）变为TRUE，并保持为TRUE直到执行完成。在此期间，无法执行其他SD存储卡指令。
执行指令时，SD存储访问完成标志（sys_blsSDMemoryAccessDone）为FALSE，指令完成后变为TRUE并保持TRUE。

错误标志

sys_bIsSDMemoryAccessError

FALSE：指令完成且没有错误时
TRUE：指令完成但有错误时
使用sys_iSDMemoryAccessErrorCode评估错误代码。

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时，执行此函数。它将目录'Test'中的文件'TestString2.csv'重命名为'TestString3.csv'。

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_CONTACT,,bStart,3,1,5,3,R);
B(B_VARIN,,'\Test\TestString2.csv',21,2,23,4,);
B(B_VARIN,,'\Test\TestString3.csv',21,3,23,5,);
B(B_CONTACT,,sys_bIsSDMemoryAccessActive,11,1,13,3,N);
B(B_F,FP_SD_RENAME_FILE!,,23,0,35,5,,?DEN?Ds1_FullFileNameOld?Ds2_FullFileNameNew?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_RENAME_FILE('\Test\TestString2.csv', '\Test\TestString3.csv');
END_IF;