函数说明

FileRead

从此前已打开的文本文件中读取指定数量的字符。

FileRead ( 文件句柄 或 "文件名", 数量 )

 

参数

文件句柄 目标文件句柄，可由此前调用 FileOpen 函数的返回值获得。另外也可以直接使用目标文件名。
数量 指定要读取字符的数量。

 

返回值

成功： 返回所读取的字符。
特殊： 把 @error 设为 -1，说明已经读到文件尾。
失败： 把 @error 设为 1，说明文件并非以读取模式打开或者有其它错误。

 

注意

若给定的是文件名而不是文件句柄，那么该文件将在函数执行期间被打开并关闭，如果打开的文件较大则会比使用文件句柄要慢得多。
注意：不要混用文件句柄和文件名，比如使用 FileOpen 函数打开某个文件然后又以文件名的形式使用本函数。在程序中要么使用文件句柄要么就使用文件名，不要两者都用！

 

相关

IniRead, FileClose, FileOpen, FileReadLine, FileWrite, FileWriteLine

 

示例


$file = FileOpen("test.txt", 0)

; 检查文件是否正常打开
If $file = -1 Then
    MsgBox(0, "错误", "无法打开目标文件。")
    Exit
EndIf

; 每次读取1个字符直到文件结尾（EOF，End-Of-File） 为止
While 1
    $chars = FileRead($file, 1)
    If @error = -1 Then ExitLoop
    MsgBox(0, "读到的字符：", $chars)
Wend

FileClose($file)