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() 常量。

如果文件已结束，则返回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() 常量。

如果文件只能按顺序操作，则返回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 的完整 OR-ed together 组合。

另请参阅 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() 常量。

返回文件的大小。

对于 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）。