FILE_ZSEEK -- 文件定位

类型

存储指令

描述

文件定位,将文件的读写位置移动到pos和mode指定的位置处。

语法

命令语法:FILE_ZSEEK (handle, pos, mode)

handle:函数FILE_ZOPEN返回的文件句柄

pos:要定位的位置或偏移,根据mode的不同,可以取负数

mode:执行定位功能时的基准位置,可取值0、1、2。

 

mode详细说明:

0:代表文件头为基准,pos指示需要定位的位置,执行后文件读写位置将定位到pos处,此种情况下pos取负值将作为0处理即定位到文件开头;

1:代表当前位置为基准,pos指示定位的偏移,执行后文件读写位置将相对当前位置移动pos,正值表示向文件尾移动,负值表示向文件头移动;

2:代表文件结尾为基准,pos指示定位的偏移,执行后文件读写位置将相对文件尾向文件头部移动-pos,此种情况pos有效取值要小于等于0,取正值将作为0处理,即定位到文件结尾。

适用控制器

4系列产品20170601以上版本支持

例子

参见FILE_ZWRITES例程

相关指令

FILE_ZOPEN,FILE_ZCLOSE,FILE_ZREAD,FILE_ZWRITES