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

Member Function Documentation

[virtual] QFileDevice::~QFileDevice()

Destroys the file device, closing it if necessary.

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

Reimplements: QIODevice::atEnd() const.

Returns true if the end of the file has been reached; otherwise returns false.

For regular empty files on Unix (e.g. those in /proc), this function returns true, since the file system reports that the size of such a file is 0. Therefore, you should not depend on atEnd() when reading data from such a file, but rather call read() until no more data can be read.

[override virtual] void QFileDevice::close()

Reimplements: QIODevice::close().

Calls QFileDevice::flush() and closes the file. Errors from flush are ignored.

See also QIODevice::close().

QFileDevice::FileError QFileDevice::error() const

Returns the file error status.

The I/O device status returns an error code. For example, if open() returns false, or a read/write operation returns -1, this function can be called to find out the reason why the operation failed.

See also unsetError().

[virtual] QString QFileDevice::fileName() const

Returns the name of the file. The default implementation in QFileDevice returns a null string.

[since 5.10] QDateTime QFileDevice::fileTime(QFileDevice::FileTime time) const

Returns the file time specified by time. If the time cannot be determined return QDateTime() (an invalid date time).

This function was introduced in Qt 5.10.

See also setFileTime(), FileTime, and QDateTime::isValid().

bool QFileDevice::flush()

Flushes any buffered data to the file. Returns true if successful; otherwise returns false.

int QFileDevice::handle() const

Returns the file handle of the file.

This is a small positive integer, suitable for use with C library functions such as fdopen() and fcntl(). On systems that use file descriptors for sockets (i.e. Unix systems, but not Windows) the handle can be used with QSocketNotifier as well.

If the file is not open, or there is an error, handle() returns -1.

See also QSocketNotifier.

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

Reimplements: QIODevice::isSequential() const.

Returns true if the file can only be manipulated sequentially; otherwise returns false.

Most files support random-access, but some special files may not.

See also QIODevice::isSequential().

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

Maps size bytes of the file into memory starting at offset. A file should be open for a map to succeed but the file does not need to stay open after the memory has been mapped. When the QFile is destroyed or a new file is opened with this object, any maps that have not been unmapped will automatically be unmapped.

The mapping will have the same open mode as the file (read and/or write), except when using MapPrivateOption, in which case it is always possible to write to the mapped memory.

Any mapping options can be passed through flags.

Returns a pointer to the memory or nullptr if there is an error.

See also unmap().

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

Returns the complete OR-ed together combination of QFile::Permission for the file.

See also setPermissions().

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

Reimplements: QIODevice::pos() const.

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

Reimplements: QIODevice::readData(char *data, qint64 maxSize).

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

Reimplements: QIODevice::readLineData(char *data, qint64 maxSize).

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

Sets the file size (in bytes) sz. Returns true if the resize succeeds; false otherwise. If sz is larger than the file currently is, the new bytes will be set to 0; if sz is smaller, the file is simply truncated.

Warning: This function can fail if the file doesn't exist.

See also size().

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

Reimplements: QIODevice::seek(qint64 pos).

For random-access devices, this function sets the current position to pos, returning true on success, or false if an error occurred. For sequential devices, the default behavior is to do nothing and return false.

Seeking beyond the end of a file: If the position is beyond the end of a file, then seek() will not immediately extend the file. If a write is performed at this position, then the file will be extended. The content of the file between the previous end of file and the newly written data is UNDEFINED and varies between platforms and file systems.

[since 5.10] bool QFileDevice::setFileTime(const QDateTime &newDate, QFileDevice::FileTime fileTime)

Sets the file time specified by fileTime to newDate, returning true if successful; otherwise returns false.

Note: The file must be open to use this function.

This function was introduced in Qt 5.10.

See also fileTime() and FileTime.

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

Sets the permissions for the file to the permissions specified. Returns true if successful, or false if the permissions cannot be modified.

Warning: This function does not manipulate ACLs, which may limit its effectiveness.

See also permissions().

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

Reimplements: QIODevice::size() const.

Returns the size of the file.

For regular empty files on Unix (e.g. those in /proc), this function returns 0; the contents of such a file are generated on demand in response to you calling read().

bool QFileDevice::unmap(uchar *address)

Unmaps the memory address.

Returns true if the unmap succeeds; false otherwise.

See also map().

void QFileDevice::unsetError()

Sets the file's error to QFileDevice::NoError.

See also error().

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

Reimplements: QIODevice::writeData(const char *data, qint64 maxSize).