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(); // Status prüfenqEnableNtfsPermissionChecks();       // turn checking on
qDisableNtfsPermissionChecks();      // turn it off again

Dokumentation der Mitgliedsfunktionen

[virtual noexcept] QFileDevice::~QFileDevice()

Zerstört das Dateigerät und schließt es, falls erforderlich.

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

Reimplements: QIODevice::atEnd() const.

Gibt true zurück, wenn das Ende der Datei erreicht wurde; andernfalls wird false zurückgegeben.

Für normale leere Dateien unter Unix (z. B. solche in /proc) gibt diese Funktion true zurück, da das Dateisystem meldet, dass die Größe einer solchen Datei 0 ist. Daher sollten Sie sich beim Lesen von Daten aus einer solchen Datei nicht auf atEnd() verlassen, sondern read() aufrufen, bis keine Daten mehr gelesen werden können.

[override virtual] void QFileDevice::close()

Reimplements: QIODevice::close().

Ruft QFileDevice::flush() auf und schließt die Datei. Fehler von flush werden ignoriert.

Siehe auch QIODevice::close().

QFileDevice::FileError QFileDevice::error() const

Gibt den Dateifehlerstatus zurück.

Der E/A-Gerätestatus gibt einen Fehlercode zurück. Wenn open() beispielsweise false zurückgibt oder eine Lese-/Schreiboperation -1 zurückgibt, kann diese Funktion aufgerufen werden, um den Grund für das Scheitern der Operation herauszufinden.

Siehe auch unsetError().

[virtual] QString QFileDevice::fileName() const

Gibt den Namen der Datei zurück. Die Standardimplementierung in QFileDevice gibt einen Null-String zurück.

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

Gibt die durch time angegebene Datei-Zeit zurück. Wenn die Zeit nicht ermittelt werden kann, wird QDateTime() zurückgegeben (eine ungültige Datumszeit).

Siehe auch setFileTime(), FileTime, und QDateTime::isValid().

bool QFileDevice::flush()

Leert alle gepufferten Daten in die Datei. Gibt bei Erfolg true zurück, andernfalls false.

int QFileDevice::handle() const

Gibt das Dateihandle der Datei zurück.

Dabei handelt es sich um eine kleine positive Ganzzahl, die für die Verwendung mit C-Bibliotheksfunktionen wie fdopen() und fcntl() geeignet ist. Auf Systemen, die Dateideskriptoren für Sockets verwenden (d. h. Unix-Systeme, aber nicht Windows), kann das Handle auch mit QSocketNotifier verwendet werden.

Wenn die Datei nicht geöffnet ist oder ein Fehler auftritt, gibt handle() -1 zurück.

Siehe auch QSocketNotifier.

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

Reimplements: QIODevice::isSequential() const.

Gibt true zurück, wenn die Datei nur sequentiell bearbeitet werden kann; andernfalls false.

Die meisten Dateien unterstützen den Zufallszugriff, aber einige spezielle Dateien möglicherweise nicht.

Siehe auch QIODevice::isSequential().

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

Bildet size Bytes der Datei in den Speicher ab, beginnend mit offset. Eine Datei muss geöffnet sein, damit eine Zuordnung gelingen kann, aber die Datei muss nicht geöffnet bleiben, nachdem der Speicher zugeordnet wurde. Wenn QFile zerstört oder eine neue Datei mit diesem Objekt geöffnet wird, werden alle noch nicht zugeordneten Maps automatisch freigegeben.

Das Mapping hat den gleichen offenen Modus wie die Datei (Lesen und/oder Schreiben), außer bei Verwendung von MapPrivateOption, in diesem Fall ist es immer möglich, in den gemappten Speicher zu schreiben.

Alle Mapping-Optionen können über flags übergeben werden.

Gibt einen Zeiger auf den Speicher oder nullptr zurück, wenn ein Fehler auftritt.

Siehe auch unmap().

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

Gibt die vollständige ODER-verknüpfte Kombination von QFile::Permission für die Datei zurück.

Siehe auch 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)

Setzt die Dateigröße (in Bytes) sz. Gibt true zurück, wenn die Größenänderung erfolgreich war; andernfalls false. Wenn sz größer ist als die Datei, werden die neuen Bytes auf 0 gesetzt; wenn sz kleiner ist, wird die Datei einfach abgeschnitten.

Siehe auch size().

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

Reimplements: QIODevice::seek(qint64 pos).

Bei Geräten mit wahlfreiem Zugriff setzt diese Funktion die aktuelle Position auf pos und gibt bei Erfolg true zurück oder false, wenn ein Fehler aufgetreten ist. Für sequentielle Geräte ist das Standardverhalten, nichts zu tun und false zurückzugeben.

Suche nach dem Ende einer Datei: Wenn die Position hinter dem Ende einer Datei liegt, wird seek() die Datei nicht sofort erweitern. Wenn an dieser Position ein Schreibvorgang durchgeführt wird, wird die Datei erweitert. Der Inhalt der Datei zwischen dem vorherigen Dateiende und den neu geschriebenen Daten ist UNDefiniert und variiert je nach Plattform und Dateisystem.

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

Setzt die durch fileTime angegebene Dateizeit auf newDate und gibt bei Erfolg true zurück, andernfalls false.

Siehe auch fileTime() und FileTime.

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

Setzt die Berechtigungen für die Datei auf die angegebene permissions. Gibt bei Erfolg true zurück, oder false, wenn die Berechtigungen nicht geändert werden können.

Siehe auch permissions().

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

Reimplements: QIODevice::size() const.

Gibt die Größe der Datei zurück.

Für normale leere Dateien unter Unix (z. B. die in /proc) gibt diese Funktion 0 zurück; der Inhalt einer solchen Datei wird bei Bedarf als Reaktion auf den Aufruf von read() erzeugt.

bool QFileDevice::unmap(uchar *address)

Hebt die Zuordnung des Speichers address auf.

Gibt true zurück, wenn das Unmap erfolgreich war; andernfalls false.

Siehe auch map().

void QFileDevice::unsetError()

Setzt den Fehler der Datei auf QFileDevice::NoError.

Siehe auch error().

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

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