QFileDevice Class

extern Q_CORE_EXPORT int qt_ntfs_permission_lookup;

qt_ntfs_permission_lookup++; // turn checking on
qt_ntfs_permission_lookup--; // turn it off again

void complexFunction()
{
    QNtfsPermissionCheckGuard permissionGuard;  // check is enabled

    // do complex things here that need permission check enabled

}   // as the guard goes out of scope the check is disabled

qAreNtfsPermissionChecksEnabled();   // 检查状态
qEnableNtfsPermissionChecks();       // turn checking on
qDisableNtfsPermissionChecks();      // turn it off again

成员函数文档

[virtual noexcept] QFileDevice::~QFileDevice()

销毁文件设备，必要时将其关闭。

[override virtual] bool QFileDevice::atEnd() const

重新实现了：QIODevice::atEnd() const。

若已到达文件末尾，则返回true ；否则返回false。

对于 Unix 系统上的普通空文件（例如位于/proc 中的文件），该函数会返回true ，因为文件系统报告此类文件的大小为 0。因此，从此类文件读取数据时，不应依赖 atEnd()，而应调用read()，直到无法再读取数据为止。

[override virtual] void QFileDevice::close()

重写了：QIODevice::close()。

调用QFileDevice::flush() 并关闭文件。来自 flush 的错误将被忽略。

另请参阅 QIODevice::close()。

QFileDevice::FileError QFileDevice::error() const

返回文件错误状态。

I/O 设备状态会返回一个错误代码。例如，如果 `open()` 返回 `false`，或者读/写操作返回 -1，则可以调用此函数来查明操作失败的原因。

另请参阅 unsetError()。

[virtual] QString QFileDevice::fileName() const

返回文件的名称。QFileDevice 中的默认实现返回一个空字符串。

QDateTime QFileDevice::fileTime(QFileDevice::FileTime time) const

返回由time 指定的文件时间。如果无法确定该时间，则返回 QDateTime()（一个无效的日期时间）。

另请参阅 setFileTime()、FileTime 以及QDateTime::isValid()。

bool QFileDevice::flush()

将缓冲区中的所有数据写入文件。如果成功，则返回true ；否则返回false 。

int QFileDevice::handle() const

返回该文件的文件句柄。

这是一个较小的正整数，适用于与 C 库函数（如 `fdopen() ` 和 `fcntl()`）配合使用。在将文件描述符用于套接字的系统上（即 Unix 系统，但不包括 Windows），该句柄也可与 `QSocketNotifier ` 配合使用。

如果文件未打开，或者发生错误，handle() 将返回 -1。

另请参阅 QSocketNotifier 。

[override virtual] bool QFileDevice::isSequential() const

重新实现了：QIODevice::isSequential() const。

如果文件只能进行顺序操作，则返回true ；否则返回false 。

大多数文件支持随机访问，但某些特殊文件可能不支持。

另请参阅 QIODevice::isSequential()。

uchar *QFileDevice::map(qint64 offset, qint64 size, QFileDevice::MemoryMapFlags flags = NoOptions)

将文件的size 字节映射到以offset 为起点的内存中。映射操作要成功，文件必须处于打开状态，但内存映射完成后，文件无需保持打开状态。当QFile 被销毁，或使用该对象打开新文件时，任何尚未解除映射的映射都会自动解除。

映射将具有与文件相同的打开模式（读取和/或写入），但使用MapPrivateOption 时除外，此时始终可以向映射的内存写入数据。

任何映射选项均可通过 `flags` 传递。

返回指向内存的指针，如果发生错误，则返回nullptr 。

另请参阅 unmap()。

[virtual] QFileDevice::Permissions QFileDevice::permissions() const

返回该文件的完整 QFile::Permission 组合（采用“或”运算）。

另请参阅 setPermissions()。

[override virtual] qint64 QFileDevice::pos() const

重新实现了：QIODevice::pos() const。

[override virtual protected] qint64 QFileDevice::readData(char *data, qint64 len)

重写了：QIODevice::readData(char *data, qint64 maxSize)。

[override virtual protected] qint64 QFileDevice::readLineData(char *data, qint64 maxlen)

重写了：QIODevice::readLineData(char *data, qint64 maxSize)。

[virtual] bool QFileDevice::resize(qint64 sz)

设置文件大小（以字节为单位）sz 。如果调整大小成功，则返回true ；否则返回false。如果sz 大于文件的当前大小，则new_bytes将被设为0；如果sz 小于当前文件大小，则文件将被截断。

另请参阅 size()。

[override virtual] bool QFileDevice::seek(qint64 pos)

重写了：QIODevice::seek （qint64 pos）。

对于随机访问设备，该函数将当前位置设置为pos ，成功时返回 true，发生错误时返回 false。对于顺序访问设备，默认行为是不执行任何操作并返回 false。

超越文件末尾的定位：如果位置超出文件末尾，则 seek() 不会立即扩展文件。如果在此位置执行写入操作，则文件将被扩展。文件中从原文件末尾到新写入数据之间的内容未定义，且因平台和文件系统而异。

bool QFileDevice::setFileTime(const QDateTime &newDate, QFileDevice::FileTime fileTime)

将由fileTime 指定的文件时间设置为newDate ，成功时返回true；否则返回false。

另请参阅 fileTime() 和FileTime 。

[virtual] bool QFileDevice::setPermissions(QFileDevice::Permissions permissions)

将文件的权限设置为指定的permissions 。如果成功，则返回true ；如果无法修改权限，则返回false 。

另请参阅 permissions()。

[override virtual] qint64 QFileDevice::size() const

重新实现了：QIODevice::size() const。

返回文件的大小。

对于 Unix 系统上的普通空文件（例如位于 `/proc` 中的文件），该函数返回 0；此类文件的内容会在您调用 `read()` 时按需生成。

bool QFileDevice::unmap(uchar *address)

释放内存address 。

如果解除映射成功，则返回true ；否则返回 false。

另请参阅 map()。

void QFileDevice::unsetError()

将文件的错误设置为QFileDevice::NoError 。

另请参阅 error()。

[override virtual protected] qint64 QFileDevice::writeData(const char *data, qint64 len)

重写了：QIODevice::writeData(const char *data, qint64 maxSize)。