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

Dokumentation der Mitgliedsfunktionen

[virtual noexcept] QFileDevice::~QFileDevice()

Löscht das Dateigerät und schließt es gegebenenfalls.

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

Implementiert: ` QIODevice::atEnd()` const.

Gibt ` true ` zurück, wenn das Ende der Datei erreicht wurde; andernfalls gibt sie `false` zurück.

Bei normalen leeren Dateien unter Unix (z. B. solchen im Verzeichnis „ /proc “) gibt diese Funktion „ true “ zurück, da das Dateisystem die Größe einer solchen Datei mit 0 angibt. Daher sollten Sie sich beim Lesen von Daten aus einer solchen Datei nicht auf `atEnd()` verlassen, sondern stattdessen ` read()` aufrufen, bis keine Daten mehr gelesen werden können.

[override virtual] void QFileDevice::close()

Implementiert: ` QIODevice::close()`.

Ruft ` QFileDevice::flush()` auf und schließt die Datei. Fehler, die bei `flush` auftreten, werden ignoriert.

Siehe auch QIODevice::close().

QFileDevice::FileError QFileDevice::error() const

Gibt den Fehlerstatus der Datei zurück.

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

Siehe auch ` unsetError()`.

[virtual] QString QFileDevice::fileName() const

Gibt den Namen der Datei zurück. Die Standardimplementierung in „ QFileDevice “ gibt eine leere Zeichenkette zurück.

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

Gibt die durch time angegebene Dateizeit zurück. Kann die Zeit nicht ermittelt werden, wird QDateTime() zurückgegeben (ein ungültiges Datums- und Zeitformat).

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

bool QFileDevice::flush()

Schreibt 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.

Dies ist 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, jedoch 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

Implementiert: ` QIODevice::isSequential()` const.

Gibt ` true ` zurück, wenn die Datei nur sequenziell bearbeitet werden kann; andernfalls wird ` false` zurückgegeben.

Die meisten Dateien unterstützen den Direktzugriff, einige spezielle Dateien jedoch möglicherweise nicht.

Siehe auch QIODevice::isSequential().

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

Ordnet „ size “ Bytes der Datei dem Speicher zu, beginnend bei „ offset “. Damit die Zuordnung erfolgreich ist, muss die Datei geöffnet sein; sie muss jedoch nach der Zuordnung nicht geöffnet bleiben. Wenn das „ QFile “-Objekt zerstört wird oder eine neue Datei mit diesem Objekt geöffnet wird, werden alle Zuordnungen, die noch nicht aufgehoben wurden, automatisch aufgehoben.

Die Zuordnung hat denselben Öffnungsmodus wie die Datei (Lesen und/oder Schreiben), außer bei Verwendung von ` MapPrivateOption`; in diesem Fall ist es immer möglich, in den zugeordneten Speicher zu schreiben.

Alle Zuordnungsoptionen können über ` flags` übergeben werden.

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

Siehe auch ` unmap()`.

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

Gibt die vollständige, mit „OR“ verknüpfte Kombination von QFile::Permission für die Datei zurück.

Siehe auch ` setPermissions()`.

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

Implementiert neu: QIODevice::pos() const.

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

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

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

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

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

Legt die Dateigröße (in Byte) sz fest. Gibt „ true “ zurück, wenn die Größenänderung erfolgreich war; andernfalls „false“. Ist sz größer als die aktuelle Dateigröße, wird der Wert von „new bytes“ auf 0 gesetzt; ist sz kleiner, wird die Datei einfach gekürzt.

Siehe auch ` size()`.

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

Implementiert: ` 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, andernfalls `false`, falls ein Fehler aufgetreten ist. Bei sequenziellen Geräten besteht das Standardverhalten darin, nichts zu tun und `false` zurückzugeben.

Springen über das Dateiende hinaus: Befindet sich die Position jenseits des Dateiendes, verlängert seek() die Datei nicht sofort. Wird an dieser Position ein Schreibvorgang durchgeführt, wird die Datei verlängert. Der Inhalt der Datei zwischen dem bisherigen Dateiende und den neu geschriebenen Daten ist UNDEFINERT 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 wird „false“ zurückgegeben.

Siehe auch „ fileTime()“ und „ FileTime “.

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

Legt die Berechtigungen für die Datei auf die angegebene Werteliste „ permissions “ fest. Gibt bei Erfolg „ true “ zurück, andernfalls „ false “, wenn die Berechtigungen nicht geändert werden können.

Siehe auch permissions().

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

Implementiert: QIODevice::size() const.

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

Bei normalen leeren Dateien unter Unix (z. B. denen in /proc) gibt diese Funktion 0 zurück; der Inhalt einer solchen Datei wird bei Bedarf generiert, wenn Sie read() aufrufen.

bool QFileDevice::unmap(uchar *address)

Hebt die Zuordnung des Speicherbereichs „ address “ auf.

Gibt ` true ` zurück, wenn das Aufheben der Zuordnung 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)

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