QFileDevice 类

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();   // check status
qEnableNtfsPermissionChecks();       // turn checking on
qDisableNtfsPermissionChecks();      // turn it off again

成员函数文档

[虚函数 noexcept] QFileDevice::~QFileDevice()

销毁文件设备，如果需要则关闭它。

[重写虚函数] bool QFileDevice::atEnd() const

重写了： QIODevice::atEnd() const.

如果已到达文件末尾返回 true；否则返回 false。

对于Unix系统中的常规空文件（例如 /proc 中的文件），此函数返回 true，因为文件系统报告这类文件的大小为0。因此，您在从这类文件读取数据时不应依赖 atEnd()，而应调用 read() 直到最后不能读取更多数据。

[重写虚拟] void QFileDevice::close()

实现： QIODevice::close().

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

另请参阅QIODevice::close。

QFileDevice::FileError QFileDevice::error() const

返回文件错误状态。

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

另请参阅unsetError。

[虚拟] 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。

[重写虚拟] 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 大于当前文件大小，则新字节将设置为 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).