Functions.FRead 方法 (IntPtr, __Usual, UInt32)

从文件中读取字符到通过引用传递的缓冲区变量中。

命名空间： XSharp.RT
程序集： XSharp.RT (在 XSharp.RT.dll 中) 版本：2.22 GA

语法

 FUNCTION FRead(
	ptrHandle AS IntPtr,
	cBufferVar REF USUAL,
	dwBytes AS DWORD
) AS DWORD

public static uint FRead(
	IntPtr ptrHandle,
	ref __Usual cBufferVar,
	uint dwBytes
)

查看代码

参数

ptrHandle: 类型：IntPtr
要读取的文件句柄。
cBufferVar: 类型：__Usual
用于存储从指定文件读取的数据的变量。
如果 cBufferVar 的长度小于 dwBytes，则分配一个新字符串，其长度为 dwBytes 和文件中剩余字节数的最小值。cBufferVar 必须通过引用传递，因此必须加上通过引用传递的操作符 (@)。
dwBytes: 类型：UInt32
要读入缓冲区的字节数。

返回值

类型：UInt32
成功读取的字节数。
返回值小于 dwBytes 或为 0 表示已到达文件末尾或发生其他读取错误。可以使用 FError() 确定具体错误。

备注

FReadText() 与 FRead() 相同，只是在 SetAnsi() 为 FALSE 时会进行 OEM 到 ANSI 的转换。

备注

提示：
这个函数是为了兼容性而包含的。我们不建议使用静态内存进行文件 I/O 操作。我们建议您使用接受字节数组参数的函数重载。

示例

此示例在成功打开文件后使用 FRead() 将 128 个字节读入缓冲区：

复制

 1DEFINE F_BLOCK := 128
 2...
 3cBuffer := Space(F_BLOCK)
 4ptrHandle := FOpen("temp.txt")
 5IF FError() != 0
 6    ? DOSErrString(FError())
 7ELSE
 8    IF FReadText(ptrHandle, @cBuffer, F_BLOCK) <paramref name="" /> F_BLOCK
 9        ? DOSErrString(FError())
10    ENDIF
11    FClose(ptrHandle)
12ENDIF