FILE_ZREADLINE -- 文件行读取

类型

存储指令

描述

从文件句柄handle指示的文件中读取一行到table的tableindex位置,最多读取maxchars个字符。

超出部分将不会读出,文件的读取位置将保持在第一个未读字符处。读取从文件当前的读取位置开始,读取结果不包含结尾的换行符,但文件读取位置将跳过换行符,函数返回读取的字符数量。读取的数量有最大限制,超出则按照最大限制读取。

语法

命令语法:FILE_ZREAD LINE (handle, tableindex, maxchars)

函数语法:num = FILE_ZREAD LINE (handle, tableindex, maxchars)

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

tableindex:table的索引,读取的字符存放到tableindex开始的table中,table每个位置存放一个字符

maxchars:table最大能够存放的字符数量,如果读取行的字符数量超出maxchars,多余的部分将不会读出,文件的读取位置将保持在第一个未读字符处

适用控制器

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

例子

DIM  handle, num

handle = FILE_ZOPEN("test.txt", "r")

FILE_ZSEEKLINE(handle, 0, 2)      '最后一行行首

num = FILE_ZREADLINE(handle, 0, 1000)    '读完后定位到行尾,行号不变

num = FILE_ZREADLINE(handle, 0, 1000)    '已到行尾,返回0

?num, table(0)         '0 0

?FILE_ZTELLLINE(handle)            '以上读取行号不变

FILE_ZSEEKLINE(handle, -1, 2)   '倒数第二行行首

num = FILE_ZREADLINE(handle, 0, 1000)   '读取倒数第二行,定位到倒数第一行行首

FILE_ZSEEKLINE(handle, -1, 1)    '上一行行首,此处为倒数第二行行首

FILE_ZSEEKLINE(handle, 17, 0)    '定位到行号17(0开始),即第18行行首

FILE_ZSEEKLINE(handle, 0, 1)     '移动到本行行首

num = FILE_ZREADLINE(handle, 0, 1000)

FILE_ZCLOSE(handle)

相关指令

FILE_ZSEEKLINE,FILE_ZTELLLINE