FILE_ZREAD -- 文件读取字符

类型

存储指令

描述

从文件句柄handle指示的文件中读取maxchars个字符,读取字符放到table中索引tableindex开始的位置。

如果读取到文件结束符,则提前终止,函数返回读取的字符数。读取的数量有最大限制,超出则按照最大限制读取。

语法

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

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

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

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

maxchars:预定读取的最大字符数量,如果读取遇到文件结束,则数量可能不足,可通过返回值获取读取数量

适用控制器

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

例子

参见FILE_ZWRITES例程

相关指令

FILE_ZOPEN,FILE_ZCLOSE,FILE_ZSEEK,FILE_ZWRITES