文章摘要
这篇文章介绍了名为 `ReadFile` 的函数，用于从指定文件读取数据。该函数支持同步和异步操作，并通过参数控制读取字节数和缓冲区存储。如果文件未以 `FILE_FLAG_OVERLAPPED` 方式打开，则函数会将实际读取的字节数保存到指定地址空间中。此外，函数要求在操作完成后调整文件指针。函数的参数包括文件句柄、缓冲区、读取字节数、返回指针和可能的 `OVERLAPPED` 结构。返回值为非零表示成功读取，零表示失败。文章还提供了一个示例，展示了如何使用该函数读取文本文件的内容。
函数说明
从文件指针指向的位置开始将数据读出到一个文件中, 且支持同步和异步操作,
如果文件打开方式没有指明FILE_FLAG_OVERLAPPED的话,当程序调用成功时,它将实际读出文件的字节数保存到lpNumberOfBytesRead指明的地址空间中
如果文件要交互使用的话,当函数调用完毕时要记得调整文件指针
函数原型 BOOL ReadFile(
|
1
2
3
4
5
6
|
HANDLE hFile, //文件的句柄LPVOID lpBuffer, //用于保存读入数据的一个缓冲区DWORD nNumberOfBytesToRead, //要读入的字符数LPDWORD lpNumberOfBytesRead, //指向实际读取字节数的指针LPOVERLAPPED lpOverlapped //如文件打开时指定了FILE_FLAG_OVERLAPPED，那么必须，用这个参数引用一个特殊的结构。该结构定义了一次异步读取操作。否则，应将这个参数设为NULL); |
参数说明
HANDLE hFile, 需要写入数据的文件指针,这个指针指向的文件必须是GENERIC_READaccess 访问属性的文件
LPOVERLAPPED lpOverlapped OVERLAPPED结构体指针,如果文件是以FILE_FLAG_OVERLAPPED方式打开的话,那么这个指针就不能为NULL
返回值
调用成功,返回非0
调用不成功,返回为0
应用示例
|
1
2
3
4
5
6
7
8
9
10
|
// 导入fs模块const fs = require('fs')// 调用readFile方法fs.readFile('1.txt', 'utf8', function (err, dataStr) { // 判断err的值是否可以转为true if (err) { return console.log('文件读取失败!', err.message); } console.log('文件读取成功!', '\n内容:' + dataStr);}) |
© 版权声明
文章版权归作者所有，未经允许请勿转载。
