FILE_ZSEEKLINE -- 文件行定位

类型

存储指令

描述

文件行定位,将文件的读写位置移动到line和mode指定的行的行首,一次定位能够处理的字符数量有限,定位的偏移量过大或长行数量较多可能导致定位未完成,可通过FILE_ZTELLLINE获取当前行位置进行判断,必要时可通过多次执行来定位。

语法

命令语法:FILE_ZSEEKLINE (handle, line, mode)

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

line:要定位行的行号或偏移,根据mode的不同,可以取负数

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

 

mode详细说明:

0:代表文件头为基准,line指示需要定位的行号,执行后文件定位到line指示行的行首,0表示定位到第一行行首;

1:代表当前行作为基准,line指示定位的行偏移,0表示定位到当前行的行首,负数表示向文件头方向进行定位;

2:代表文件结尾为基准,line指示定位的行偏移,0表示定位到最后一行的行首,负数则依次向文件头方向进行定位。

适用控制器

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

例子

参见FILE_ZREADLINE例程

相关指令

FILE_ZREADLINE,FILE_ZTELLLINE