QFileInfo Class

Dokumentation zu den Member-Funktionen

QFileInfo::QFileInfo()

Erstellt ein leeres QFileInfo-Objekt, das auf keinen Dateisystemeintrag verweist.

Siehe auch ` setFile()`.

[explicit] QFileInfo::QFileInfo(const QFileDevice &file)

Erstellt ein neues QFileInfo-Objekt, das Informationen zur Datei file liefert.

Wenn der „ file “ einen relativen Pfad hat, hat das QFileInfo ebenfalls einen relativen Pfad.

Siehe auch „ isRelative()“.

[explicit] QFileInfo::QFileInfo(const QString &path)

Erstellt ein `QFileInfo`-Objekt, das Informationen über einen Dateisystemeintrag unter ` path ` liefert, wobei ` ` absolut oder relativ sein kann.

Ist path relativ, verfügt das QFileInfo ebenfalls über einen relativen Pfad.

Siehe auch ` setFile()`, ` isRelative()`, ` QDir::setCurrent()` und ` QDir::isRelativePath()`.

[since 6.0] QFileInfo::QFileInfo(const std::filesystem::path &file)

Erstellt ein neues QFileInfo-Objekt, das Informationen über den angegebenen „ file “ liefert.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch „ setFile()“, „ isRelative()“, „ QDir::setCurrent()“ und „ QDir::isRelativePath()“.

[explicit] QFileInfo::QFileInfo(const QDir &dir, const QString &path)

Erstellt ein neues QFileInfo-Objekt, das Informationen über den angegebenen Dateisystemeintrag path liefert, der relativ zum Verzeichnis dir ist.

Wenn dir einen relativen Pfad hat, hat das QFileInfo ebenfalls einen relativen Pfad.

Ist ` path ` absolut, wird das durch ` dir ` angegebene Verzeichnis ignoriert.

Siehe auch isRelative().

[since 6.0] QFileInfo::QFileInfo(const QDir &dir, const std::filesystem::path &path)

Erstellt ein neues QFileInfo-Objekt, das Informationen über den Dateisystemeintrag unter path liefert, relativ zum Verzeichnis dir.

Wenn dir einen relativen Pfad hat, hat das QFileInfo ebenfalls einen relativen Pfad.

Ist path absolut, wird das durch dir angegebene Verzeichnis ignoriert.

Diese Funktion wurde in Qt 6.0 eingeführt.

QFileInfo::QFileInfo(const QFileInfo &fileinfo)

Erstellt ein neues `QFileInfo`-Objekt, das eine Kopie des angegebenen ` fileinfo` ist.

[constexpr noexcept default, since 6.12] QFileInfo::QFileInfo(QFileInfo &&other)

Erstellt ein neues `QFileInfo`-Objekt aus ` other`.

Diese Funktion wurde in Qt 6.12 eingeführt.

[noexcept] QFileInfo::~QFileInfo()

Löscht den „ QFileInfo “ und gibt dessen Ressourcen frei.

QDir QFileInfo::absoluteDir() const

Gibt ein ` QDir `-Objekt zurück, das den absoluten Pfad des übergeordneten Verzeichnisses des Dateisystemeintrags darstellt, auf den sich diese ` QFileInfo ` bezieht.

// Angenommen, das aktuelle Arbeitsverzeichnis lautet „/home/user/Documents/memos/“
QFileInfo info1(u"relativeFile"_s);
qDebug() << info1.absolutePath(); // "/home/user/Documents/memos/"
qDebug() << info1.baseName(); // "relativeFile"
qDebug() << info1.absoluteDir(); // QDir(u"/home/user/Documents/memos"_s)
qDebug() << info1.absoluteDir().path(); // "/home/user/Documents/memos"

// Ein QFileInfo-Objekt für ein Verzeichnis
QFileInfo info2(u"/home/user/Documents/memos"_s);
qDebug() << info2.absolutePath(); // "/home/user/Documents"
qDebug() << info2.baseName(); // "memos"
qDebug() << info2.absoluteDir(); // QDir(u"/home/user/Documents"_s)
qDebug() << info2.absoluteDir().path(); // "/home/user/Documents"

Siehe auch dir(), filePath(), fileName() und isRelative().

QString QFileInfo::absoluteFilePath() const

Gibt den absoluten vollständigen Pfad zu dem Dateisystemeintrag zurück, auf den sich „ QFileInfo “ bezieht, einschließlich des Namens des Eintrags.

Unter Unix beginnen absolute Pfade mit dem Verzeichnistrennzeichen '/'. Unter Windows beginnen absolute Pfade mit einer Laufwerksangabe (zum Beispiel D:/).

Unter Windows beginnen die Pfade von Netzwerkfreigaben, die keinem Laufwerksbuchstaben zugeordnet sind, mit //sharename/.

QFileInfo wandelt Laufwerksbuchstaben in Großbuchstaben um. Beachten Sie, dass QDir dies nicht tut. Der folgende Codeausschnitt veranschaulicht dies.

    QFileInfo fi("c:/temp/foo");
    qDebug() << fi.absoluteFilePath(); // "C:/temp/foo"

Diese Funktion liefert dasselbe Ergebnis wie ` filePath()`, es sei denn, ` isRelative()` ist wahr. Im Gegensatz zu ` canonicalFilePath()` werden symbolische Links oder überflüssige „.“- oder „..“-Elemente nicht unbedingt entfernt.

Siehe auch filePath(), canonicalFilePath() und isRelative().

QString QFileInfo::absolutePath() const

Gibt den absoluten Pfad des Dateisystem-Eintrags zurück, auf den sich „ QFileInfo “ bezieht, wobei der Name des Eintrags nicht berücksichtigt wird.

Unter Unix beginnen absolute Pfade mit dem Verzeichnistrennzeichen „ '/' “. Unter Windows beginnen absolute Pfade mit einer Laufwerksangabe (zum Beispiel „ D:/ “).

Unter Windows beginnen die Pfade von Netzwerkfreigaben, die keinem Laufwerksbuchstaben zugeordnet sind, mit //sharename/.

Im Gegensatz zu canonicalPath() werden symbolische Links oder überflüssige „.“- oder „..“-Elemente nicht unbedingt entfernt.

Siehe auch absoluteFilePath(), path(), canonicalPath(), fileName() und isRelative().

QString QFileInfo::baseName() const

Gibt den Basisnamen der Datei ohne den Pfad zurück.

Der Basisname besteht aus allen Zeichen der Datei bis zum ersten „.“-Zeichen (dieses jedoch nicht mitgerechnet).

Beispiel:

QFileInfo fi("/tmp/archive.tar.gz");
QString base = fi.baseName();  // base = "archive"

Der Basisname einer Datei wird auf allen Plattformen einheitlich berechnet, unabhängig von Dateinamenskonventionen (z. B. hat „.bashrc“ unter Unix einen leeren Basisnamen, und die Endung lautet „bashrc“).

Siehe auch fileName(), suffix(), completeSuffix() und completeBaseName().

QDateTime QFileInfo::birthTime() const

Gibt das Datum und die Uhrzeit der Erstellung (Entstehung) der Datei in Ortszeit zurück.

Wenn der Erstellungszeitpunkt der Datei nicht verfügbar ist, gibt diese Funktion einen ungültigen Wert „ QDateTime “ zurück.

Handelt es sich bei der Datei um einen Symlink, gibt diese Funktion Informationen über das Ziel zurück, nicht über den Symlink.

Diese Funktion überlädt QFileInfo::birthTime(const QTimeZone &tz) und liefert dasselbe Ergebnis wie birthTime(QTimeZone::LocalTime).

Siehe auch lastModified(), lastRead(), metadataChangeTime() und fileTime().

[since 6.6] QDateTime QFileInfo::birthTime(const QTimeZone &tz) const

Gibt das Datum und die Uhrzeit zurück, zu der die Datei erstellt (entstanden) wurde.

Die zurückgegebene Zeit liegt in der durch ` tz` angegebenen Zeitzone. Sie können beispielsweise ` QTimeZone::LocalTime ` oder ` QTimeZone::UTC ` verwenden, um die Zeit in der lokalen Zeitzone bzw. in UTC abzurufen. Da die native Dateisystem-API in der Regel UTC verwendet, ist die Verwendung von ` QTimeZone::UTC ` oft schneller, da keine Umrechnungen erforderlich sind.

Wenn der Erstellungszeitpunkt der Datei nicht verfügbar ist, gibt diese Funktion einen ungültigen Wert zurück: ` QDateTime`.

Handelt es sich bei der Datei um einen Symlink, gibt diese Funktion Informationen über das Ziel zurück, nicht über den Symlink.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch ` lastModified` (const QTimeZone &), ` lastRead` (const QTimeZone &), ` metadataChangeTime` (const QTimeZone &) und ` fileTime` (QFileDevice::FileTime, const QTimeZone &).

QString QFileInfo::bundleName() const

Gibt den Namen des Bundles zurück.

Unter macOS und iOS wird der korrekte lokalisierte Name eines Bundles zurückgegeben, wenn der Pfad „ isBundle “ () lautet. Auf allen anderen Plattformen wird ein leeres „ QString “ zurückgegeben.

Beispiel:

QFileInfo fi("/Applications/Safari.app");
QString bundle = fi.bundleName();                // name = "Safari"

Siehe auch isBundle(), filePath(), baseName() und suffix().

bool QFileInfo::caching() const

Gibt „ true “ zurück, wenn das Caching aktiviert ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch setCaching() und refresh().

QString QFileInfo::canonicalFilePath() const

Gibt den kanonischen Pfad des Dateisystem-Eintrags zurück, einschließlich des Namens des Eintrags, d. h. einen absoluten Pfad ohne symbolische Links oder überflüssige „ '.' “- oder „ '..' “-Elemente.

Diese Methode gibt eine leere Zeichenkette zurück, wenn der Eintrag nicht existiert, nicht erreichbar ist (beispielsweise hat der aktuelle Benutzer keinen Zugriff auf einen Verzeichnispfad) oder wenn beim Kanonisieren des Pfads ein Fehler auftritt (normalerweise aufgrund hängender symbolischer Links).

Siehe auch filePath(), absoluteFilePath() und dir().

QString QFileInfo::canonicalPath() const

Gibt den kanonischen Pfad des Dateisystem-Eintrags (ohne den Namen des Eintrags) zurück, d. h. einen absoluten Pfad ohne symbolische Links oder überflüssige „.“- oder „..“-Elemente.

Diese Methode gibt eine leere Zeichenkette zurück, wenn der Eintrag nicht existiert, nicht erreichbar ist (z. B. wenn der aktuelle Benutzer keinen Zugriff auf einen Verzeichnispfad hat) oder wenn bei der Kanonisierung des Pfads ein Fehler auftritt (normalerweise aufgrund von hängenden symbolischen Links).

Siehe auch path() und absolutePath().

QString QFileInfo::completeBaseName() const

Gibt den vollständigen Basisnamen der Datei ohne den Pfad zurück.

Der vollständige Basisname besteht aus allen Zeichen der Datei bis zum letzten „.“-Zeichen (dieses jedoch nicht mit eingeschlossen).

Beispiel:

QFileInfo fi("/tmp/archive.tar.gz");
QString base = fi.completeBaseName();  // base = "archive.tar"

Siehe auch fileName(), suffix(), completeSuffix() und baseName().

QString QFileInfo::completeSuffix() const

Gibt das vollständige Suffix (die Dateiendung) der Datei zurück.

Die vollständige Dateiendung besteht aus allen Zeichen in der Datei nach dem ersten „.“ (dieses selbst nicht mitgerechnet).

Beispiel:

QFileInfo fi("/tmp/archive.tar.gz");
QString ext = fi.completeSuffix();  // ext = "tar.gz"

Siehe auch fileName(), suffix(), baseName() und completeBaseName().

QDir QFileInfo::dir() const

Gibt ein ` QDir `-Objekt zurück, das den Pfad des übergeordneten Verzeichnisses des Dateisystemeintrags darstellt, auf den sich dieser ` QFileInfo ` bezieht.

In jedem der folgenden Fälle gibt dir() den „ QDir “ "~/examples/191697" zurück.

    QFileInfo fileInfo1("~/examples/191697/.");
    QFileInfo fileInfo2("~/examples/191697/..");
    QFileInfo fileInfo3("~/examples/191697/main.cpp");

Für jeden der folgenden Fälle gibt dir() die „ QDir “ "." zurück.

    QFileInfo fileInfo4(".");
    QFileInfo fileInfo5("..");
    QFileInfo fileInfo6("main.cpp");

Siehe auch absolutePath(), filePath(), fileName(), isRelative() und absoluteDir().

bool QFileInfo::exists() const

Gibt „ true “ zurück, wenn der Dateisystemeintrag, auf den „ QFileInfo “ verweist, existiert; andernfalls wird „ false “ zurückgegeben.

[static] bool QFileInfo::exists(const QString &path)

Gibt „ true “ zurück, wenn der Dateisystemeintrag „ path “ existiert; andernfalls wird „ false “ zurückgegeben.

QString QFileInfo::fileName() const

Gibt den Namen des Dateisystem-Eintrags zurück, auf den dieser ` QFileInfo ` verweist, ohne den Pfad.

Beispiel:

QFileInfo fi("/tmp/archive.tar.gz");
QString name = fi.fileName();                // name = "archive.tar.gz"

Siehe auch isRelative(), filePath(), baseName() und suffix().

QString QFileInfo::filePath() const

Gibt den Pfad des Dateisystem-Eintrags zurück, auf den diese QFileInfo verweist; der Pfad kann absolut oder relativ sein.

Siehe auch absoluteFilePath(), canonicalFilePath() und isRelative().

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

Gibt den durch ` time` angegebenen Dateizeitstempel zurück.

Kann der Zeitpunkt nicht ermittelt werden, wird ein ungültiges Datums- und Zeitformat zurückgegeben.

Handelt es sich bei der Datei um einen Symlink, gibt diese Funktion Informationen über das Ziel zurück, nicht über den Symlink.

Diese Funktion überlädt ` QFileInfo::fileTime(QFileDevice::FileTime, const QTimeZone &)` und liefert dasselbe Ergebnis wie ` fileTime(time, QTimeZone::LocalTime)`.

Siehe auch birthTime(), lastModified(), lastRead() und metadataChangeTime().

[since 6.6] QDateTime QFileInfo::fileTime(QFileDevice::FileTime time, const QTimeZone &tz) const

Gibt die durch time angegebene Dateizeit zurück.

Die zurückgegebene Zeit liegt in der durch ` tz` angegebenen Zeitzone. Sie können beispielsweise ` QTimeZone::LocalTime ` oder ` QTimeZone::UTC ` verwenden, um die Zeit in der lokalen Zeitzone bzw. in UTC zu erhalten. Da die native Dateisystem-API in der Regel UTC verwendet, ist die Verwendung von ` QTimeZone::UTC ` oft schneller, da keine Umrechnungen erforderlich sind.

Kann die Uhrzeit nicht ermittelt werden, wird ein ungültiges Datums- und Zeitformat zurückgegeben.

Handelt es sich bei der Datei um einen Symlink, gibt diese Funktion Informationen über das Ziel zurück, nicht über den Symlink.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch birthTime(const QTimeZone &), lastModified(const QTimeZone &), lastRead(const QTimeZone &), metadataChangeTime(const QTimeZone &) und QDateTime::isValid().

[since 6.0] std::filesystem::path QFileInfo::filesystemAbsoluteFilePath() const

Gibt „ absoluteFilePath()“ als „ std::filesystem::path “ zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` absoluteFilePath()`.

[since 6.0] std::filesystem::path QFileInfo::filesystemAbsolutePath() const

Gibt „ absolutePath()“ als „ std::filesystem::path “ zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` absolutePath()`.

[since 6.0] std::filesystem::path QFileInfo::filesystemCanonicalFilePath() const

Gibt „ canonicalFilePath()“ als „ std::filesystem::path “ zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` canonicalFilePath()`.

[since 6.0] std::filesystem::path QFileInfo::filesystemCanonicalPath() const

Gibt „ canonicalPath()“ als „ std::filesystem::path “ zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` canonicalPath()`.

[since 6.0] std::filesystem::path QFileInfo::filesystemFilePath() const

Gibt „ filePath()“ als „ std::filesystem::path “ zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` filePath()`.

[since 6.2] std::filesystem::path QFileInfo::filesystemJunctionTarget() const

Gibt ` junctionTarget()` als ` std::filesystem::path` zurück.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch ` junctionTarget()`.

[since 6.0] std::filesystem::path QFileInfo::filesystemPath() const

Gibt ` path()` als ` std::filesystem::path` zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch path().

[since 6.6] std::filesystem::path QFileInfo::filesystemReadSymLink() const

Gibt ` readSymLink()` als ` std::filesystem::path` zurück.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch ` readSymLink()`.

[since 6.0] std::filesystem::path QFileInfo::filesystemSymLinkTarget() const

Gibt ` symLinkTarget()` als ` std::filesystem::path` zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` symLinkTarget()`.

QString QFileInfo::group() const

Gibt die Gruppe der Datei zurück. Unter Windows, auf Systemen, auf denen Dateien keine Gruppen haben, oder wenn ein Fehler auftritt, wird eine leere Zeichenkette zurückgegeben.

Diese Funktion kann unter Unix zeitaufwendig sein (in der Größenordnung von Millisekunden).

Handelt es sich bei der Datei um einen Symlink, gibt diese Funktion Informationen über das Ziel zurück, nicht über den Symlink.

Siehe auch groupId(), owner() und ownerId().

uint QFileInfo::groupId() const

Gibt die ID der Gruppe zurück, zu der die Datei gehört.

Unter Windows und auf Systemen, auf denen Dateien keine Gruppen haben, gibt diese Funktion immer (uint) -2 zurück.

Wenn es sich bei der Datei um einen symbolischen Link handelt, gibt diese Funktion Informationen über das Ziel zurück, nicht über den symbolischen Link.

Siehe auch group(), owner() und ownerId().

bool QFileInfo::isAbsolute() const

Gibt „ true “ zurück, wenn der Pfad des Dateisystemeintrags absolut ist; andernfalls wird „ false “ zurückgegeben (d. h., der Pfad ist relativ).

Siehe auch isRelative().

[since 6.4] bool QFileInfo::isAlias() const

Gibt „ true “ zurück, wenn dieses Objekt auf einen Alias verweist; andernfalls wird „ false “ zurückgegeben.

Aliase gibt es nur unter macOS. Sie werden wie normale Dateien behandelt, sodass beim Öffnen eines Alias die Datei selbst geöffnet wird. Um die Datei oder das Verzeichnis zu öffnen, auf die bzw. das ein Alias verweist, verwenden Sie ` symLinkTarget()`.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch ` isFile()`, ` isDir()`, ` isSymLink()` und ` symLinkTarget()`.

bool QFileInfo::isBundle() const

Gibt „ true “ zurück, wenn dieses Objekt unter macOS und iOS auf ein Bundle oder einen symbolischen Link zu einem Bundle verweist; andernfalls wird „ false “ zurückgegeben.

Wenn es sich bei der Datei um einen symbolischen Link handelt, gibt diese Funktion Informationen über das Ziel zurück, nicht über den symbolischen Link.

Siehe auch isDir(), isSymLink() und isFile().

bool QFileInfo::isDir() const

Gibt „ true “ zurück, wenn dieses Objekt auf ein Verzeichnis oder auf einen symbolischen Link zu einem Verzeichnis verweist. Gibt „ false “ zurück, wenn das Objekt auf etwas verweist, das kein Verzeichnis ist (z. B. eine Datei) oder das nicht existiert.

Wenn es sich bei der Datei um einen symbolischen Link handelt, gibt diese Funktion Informationen über das Ziel zurück, nicht über den symbolischen Link.

Siehe auch isFile(), isSymLink() und isBundle().

bool QFileInfo::isExecutable() const

Gibt „ true “ zurück, wenn der Dateisystemeintrag, auf den „ QFileInfo “ verweist, ausführbar ist; andernfalls wird „ false “ zurückgegeben.

Handelt es sich bei der Datei um einen symbolischen Link, gibt diese Funktion Informationen über das Ziel zurück, nicht über den symbolischen Link.

Siehe auch isReadable(), isWritable() und permission().

bool QFileInfo::isFile() const

Gibt „ true “ zurück, wenn dieses Objekt auf eine Datei oder einen symbolischen Link zu einer Datei verweist. Gibt „ false “ zurück, wenn das Objekt auf etwas verweist, das keine Datei ist (z. B. ein Verzeichnis) oder nicht existiert.

Wenn es sich bei der Datei um einen symbolischen Link handelt, gibt diese Funktion Informationen über das Ziel zurück, nicht über den symbolischen Link.

Siehe auch isDir(), isSymLink() und isBundle().

bool QFileInfo::isHidden() const

Gibt ` true ` zurück, wenn der Dateisystemeintrag, auf den ` QFileInfo ` verweist, „versteckt“ ist; andernfalls wird ` false` zurückgegeben.

Hinweis: Diese Funktion gibt unter Unix für die speziellen Einträge „.“ und „..“ den Wert ` true ` zurück, obwohl ` QDir::entryList ` sie wie gezeigt behandelt. Beachten Sie außerdem, dass diese Funktion den Dateinamen überprüft; unter Unix wird daher der Name des symbolischen Links überprüft, falls es sich bei dieser Datei um einen symbolischen Link handelt, und nicht der Name des Ziels.

Unter Windows gibt diese Funktion „ true “ zurück, wenn die Zieldatei (nicht der symbolische Link) versteckt ist.

bool QFileInfo::isJunction() const

Gibt „ true “ zurück, wenn das Objekt auf eine Verknüpfung verweist; andernfalls wird „ false “ zurückgegeben.

Verzweigungen existieren nur im NTFS-Dateisystem von Windows und werden in der Regel mit dem Befehl „ mklink “ erstellt. Sie können als symbolische Links für Verzeichnisse betrachtet werden und können nur für absolute Pfade auf dem lokalen Datenträger erstellt werden.

bool QFileInfo::isNativePath() const

Gibt „ true “ zurück, wenn der Dateipfad direkt mit nativen APIs verwendet werden kann. Gibt „ false “ zurück, wenn die Datei anderweitig von einem virtuellen Dateisystem innerhalb von Qt unterstützt wird, wie beispielsweise dem Qt Resource System.

Hinweis: Bei nativen Pfaden kann je nach Plattform und Eingabeanforderungen der nativen API dennoch eine Konvertierung von Pfadtrennzeichen und Zeichenkodierung erforderlich sein.

Siehe auch QDir::toNativeSeparators(), QFile::encodeName(), filePath(), absoluteFilePath() und canonicalFilePath().

[since 6.10] bool QFileInfo::isOther() const

Gibt „ true “ zurück, wenn sich „ QFileInfo “ auf einen Dateisystemeintrag bezieht, der kein Verzeichnis, keine reguläre Datei und kein symbolischer Link ist. Andernfalls wird „ false “ zurückgegeben.

Bezieht sich dieser ` QFileInfo ` auf einen nicht vorhandenen Eintrag, gibt diese Methode ` false` zurück.

Ist der Eintrag ein „dangling“ symbolischer Link (das Ziel existiert nicht), gibt diese Methode ` false` zurück. Bei einem nicht „dangling“ symbolischen Link gibt diese Funktion Informationen über das Ziel zurück, nicht über den symbolischen Link.

Unter Unix ist ein spezieller (anderer) Dateisystemeintrag ein FIFO, ein Socket, ein Zeichen- oder ein Blockgerät. Weitere Details finden Sie in der mknod Manpage.

Unter Windows (aus historischen Gründen, siehe Symbolic Links and Shortcuts) gibt diese Methode für „ .lnk “-Dateien „ true “ zurück.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch isDir(), isFile(), isSymLink() und QDirListing::IteratorFlag::ExcludeOther.

bool QFileInfo::isReadable() const

Gibt „ true “ zurück, wenn der Benutzer den Dateisystemeintrag lesen kann, auf den „ QFileInfo “ verweist; andernfalls wird „ false “ zurückgegeben.

Handelt es sich bei der Datei um einen Symlink, gibt diese Funktion Informationen über das Ziel zurück, nicht über den Symlink.

Siehe auch isWritable(), isExecutable() und permission().

bool QFileInfo::isRelative() const

Gibt „ true “ zurück, wenn der Pfad des Dateisystemeintrags relativ ist; andernfalls wird „ false “ zurückgegeben (d. h., der Pfad ist absolut).

Unter Unix beginnen absolute Pfade mit dem Verzeichnistrennzeichen „ '/' “. Unter Windows beginnen absolute Pfade mit einer Laufwerksangabe (zum Beispiel „ D:/ “).

Siehe auch ` isAbsolute()`.

bool QFileInfo::isRoot() const

Gibt „ true “ zurück, wenn das Objekt auf ein Verzeichnis oder einen symbolischen Link zu einem Verzeichnis verweist und dieses Verzeichnis das Stammverzeichnis ist; andernfalls wird „ false “ zurückgegeben.

bool QFileInfo::isShortcut() const

Gibt „ true “ zurück, wenn dieses Objekt auf eine Verknüpfung verweist; andernfalls wird „ false “ zurückgegeben.

Verknüpfungen gibt es nur unter Windows und es handelt sich dabei in der Regel um „ .lnk “-Dateien. So wird beispielsweise für Verknüpfungen (Dateien vom Typ „*.lnk “) unter Windows „true“ zurückgegeben, unter Unix (einschließlich macOS und iOS) hingegen „false“.

Die Verknüpfungsdateien (.lnk) werden wie normale Dateien behandelt. Werden diese geöffnet, wird die eigentliche „ .lnk “-Datei geöffnet. Um die Datei zu öffnen, auf die eine Verknüpfung verweist, muss „ symLinkTarget()“ auf eine Verknüpfung angewendet werden.

Siehe auch „ isFile()“, „ isDir()“, „ isSymbolicLink()“ und „ symLinkTarget()“.

bool QFileInfo::isSymLink() const

Gibt „ true “ zurück, wenn dieses Objekt auf einen symbolischen Link, eine Verknüpfung oder einen Alias verweist; andernfalls wird „ false “ zurückgegeben.

Symbolische Links gibt es unter Unix (einschließlich macOS und iOS) sowie unter Windows und werden in der Regel durch die Befehle „ ln -s “ bzw. „ mklink “ erstellt. Das Öffnen eines symbolischen Links bewirkt das Öffnen der Datei „ link's target “.

Darüber hinaus wird für Verknüpfungen (Dateien vom Typ „*.lnk “) unter Windows und für Aliase unter macOS der Wert „true“ zurückgegeben. Dieses Verhalten ist veraltet und wird sich in einer zukünftigen Version von Qt XML wahrscheinlich ändern. Das Öffnen einer Verknüpfung oder eines Alias führt zum Öffnen der Datei „ .lnk “ bzw. der Alias-Datei selbst.

Beispiel:

QFileInfo info(fileName);
if (info.isSymLink())
    fileName = info.symLinkTarget();

Siehe auch „ isFile()“, „ isDir()“ und „ symLinkTarget()“.

bool QFileInfo::isSymbolicLink() const

Gibt „ true “ zurück, wenn dieses Objekt auf einen symbolischen Link verweist; andernfalls wird „ false “ zurückgegeben.

Symbolische Links gibt es unter Unix (einschließlich macOS und iOS) sowie unter Windows (NTFS-Symlink) und werden in der Regel mit den Befehlen „ ln -s “ bzw. „ mklink “ erstellt.

Unix behandelt symbolische Links transparent. Das Öffnen eines symbolischen Links öffnet effektiv die Datei „ link's target “.

Im Gegensatz zu ` isSymLink()` wird für Verknüpfungen (Dateien vom Typ `*.lnk `) unter Windows und für Aliase unter macOS der Wert `false` zurückgegeben. Verwenden Sie stattdessen ` QFileInfo::isShortcut()` und ` QFileInfo::isAlias()`.

Siehe auch isFile(), isDir(), isShortcut() und symLinkTarget().

bool QFileInfo::isWritable() const

Gibt „ true “ zurück, wenn der Benutzer Schreibzugriff auf den Dateisystemeintrag hat, auf den „ QFileInfo “ verweist; andernfalls wird „ false “ zurückgegeben.

Wenn es sich bei der Datei um einen symbolischen Link handelt, gibt diese Funktion Informationen über das Ziel zurück, nicht über den symbolischen Link.

Siehe auch isReadable(), isExecutable() und permission().

[since 6.2] QString QFileInfo::junctionTarget() const

Löst eine NTFS-Verknüpfung in den Pfad auf, auf den sie verweist.

Gibt den absoluten Pfad zu dem Verzeichnis zurück, auf das eine NTFS-Verknüpfung verweist, oder eine leere Zeichenfolge, wenn das Objekt keine NTFS-Verknüpfung ist.

Es gibt keine Garantie dafür, dass das durch die NTFS-Verknüpfung benannte Verzeichnis tatsächlich existiert.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch isJunction(), isFile(), isDir(), isSymLink(), isSymbolicLink() und isShortcut().

QDateTime QFileInfo::lastModified() const

Gibt das Datum und die Uhrzeit zurück, zu der die Datei zuletzt geändert wurde.

Handelt es sich bei der Datei um einen symbolischen Link, gibt diese Funktion Informationen über das Ziel zurück, nicht über den symbolischen Link.

Diese Funktion überlädt ` QFileInfo::lastModified(const QTimeZone &)` und liefert dasselbe Ergebnis wie ` lastModified(QTimeZone::LocalTime)`.

Siehe auch birthTime(), lastRead(), metadataChangeTime() und fileTime().

[since 6.6] QDateTime QFileInfo::lastModified(const QTimeZone &tz) const

Gibt das Datum und die Uhrzeit zurück, zu denen die Datei zuletzt geändert wurde.

Die zurückgegebene Zeit wird in der durch ` tz` angegebenen Zeitzone ausgegeben. Sie können beispielsweise ` QTimeZone::LocalTime ` oder ` QTimeZone::UTC ` verwenden, um die Zeit in der lokalen Zeitzone bzw. in UTC abzurufen. Da die native Dateisystem-API in der Regel UTC verwendet, ist die Verwendung von ` QTimeZone::UTC ` oft schneller, da keine Umrechnungen erforderlich sind.

Handelt es sich bei der Datei um einen symbolischen Link, gibt diese Funktion Informationen über das Ziel zurück, nicht über den symbolischen Link.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch birthTime(const QTimeZone &), lastRead(const QTimeZone &), metadataChangeTime(const QTimeZone &) und fileTime(QFileDevice::FileTime, const QTimeZone &).

QDateTime QFileInfo::lastRead() const

Gibt das Datum und die Uhrzeit zurück, zu der die Datei zuletzt gelesen (aufgerufen) wurde.

Auf Plattformen, auf denen diese Informationen nicht verfügbar sind, wird derselbe Zeitpunkt wie bei ` lastModified()` zurückgegeben.

Handelt es sich bei der Datei um einen symbolischen Link, gibt diese Funktion Informationen über das Ziel zurück, nicht über den symbolischen Link.

Diese Funktion überlädt ` QFileInfo::lastRead(const QTimeZone &)` und liefert dasselbe Ergebnis wie ` lastRead(QTimeZone::LocalTime)`.

Siehe auch birthTime(), lastModified(), metadataChangeTime() und fileTime().

[since 6.6] QDateTime QFileInfo::lastRead(const QTimeZone &tz) const

Gibt das Datum und die Uhrzeit zurück, zu der die Datei zuletzt gelesen (aufgerufen) wurde.

Die zurückgegebene Zeit liegt in der durch ` tz` angegebenen Zeitzone. Sie können beispielsweise ` QTimeZone::LocalTime ` oder ` QTimeZone::UTC ` verwenden, um die Zeit in der lokalen Zeitzone bzw. in UTC abzurufen. Da die native Dateisystem-API in der Regel UTC verwendet, ist die Verwendung von ` QTimeZone::UTC ` oft schneller, da keine Umrechnungen erforderlich sind.

Auf Plattformen, auf denen diese Informationen nicht verfügbar sind, gibt die Funktion dieselbe Zeit wie lastModified() zurück.

Wenn es sich bei der Datei um einen Symlink handelt, gibt diese Funktion Informationen über das Ziel zurück, nicht über den Symlink.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch ` birthTime(const QTimeZone &)`, ` lastModified(const QTimeZone &)`, ` metadataChangeTime(const QTimeZone &)` und ` fileTime(QFileDevice::FileTime, const QTimeZone &)`.

bool QFileInfo::makeAbsolute()

Ist der Pfad des Dateisystem-Eintrags relativ, wandelt diese Methode ihn in einen absoluten Pfad um und gibt „ true “ zurück; ist der Pfad bereits absolut, gibt diese Methode „ false “ zurück.

Siehe auch filePath() und isRelative().

QDateTime QFileInfo::metadataChangeTime() const

Gibt das Datum und die Uhrzeit zurück, zu denen die Metadaten der Datei zuletzt geändert wurden (in Ortszeit).

Eine Änderung der Metadaten erfolgt beim erstmaligen Erstellen der Datei, aber auch immer dann, wenn der Benutzer Inode-Informationen schreibt oder festlegt (z. B. beim Ändern der Dateiberechtigungen).

Handelt es sich bei der Datei um einen Symlink, gibt diese Funktion Informationen über das Ziel zurück, nicht über den Symlink.

Diese Funktion überlädt `QFileInfo::metadataChangeTime(const QTimeZone &tz)` und liefert dasselbe Ergebnis wie ` metadataChangeTime(QTimeZone::LocalTime)`.

Siehe auch birthTime(), lastModified(), lastRead() und fileTime().

[since 6.6] QDateTime QFileInfo::metadataChangeTime(const QTimeZone &tz) const

Gibt das Datum und die Uhrzeit zurück, zu denen die Metadaten der Datei zuletzt geändert wurden. Eine Änderung der Metadaten erfolgt beim erstmaligen Erstellen der Datei, aber auch immer dann, wenn der Benutzer Inode-Informationen schreibt oder festlegt (beispielsweise beim Ändern der Dateiberechtigungen).

Die zurückgegebene Zeit wird in der Zeitzone angegeben, die durch ` tz` festgelegt ist. Beispielsweise können Sie ` QTimeZone::LocalTime ` oder ` QTimeZone::UTC ` verwenden, um die Zeit in der lokalen Zeitzone bzw. in UTC abzurufen. Da die native Dateisystem-API in der Regel UTC verwendet, ist die Verwendung von ` QTimeZone::UTC ` oft schneller, da keine Umrechnungen erforderlich sind.

Handelt es sich bei der Datei um einen symbolischen Link, gibt diese Funktion Informationen über das Ziel zurück, nicht über den symbolischen Link.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch birthTime(const QTimeZone &), lastModified(const QTimeZone &), lastRead(const QTimeZone &) und fileTime(QFileDevice::FileTime time, const QTimeZone &).

QString QFileInfo::owner() const

Gibt den Eigentümer der Datei zurück. Auf Systemen, auf denen Dateien keine Eigentümer haben, oder wenn ein Fehler auftritt, wird eine leere Zeichenkette zurückgegeben.

Diese Funktion kann unter Unix zeitaufwendig sein (in der Größenordnung von Millisekunden). Unter Windows gibt sie eine leere Zeichenkette zurück, sofern die Überprüfung „ NTFS permissions “ nicht aktiviert wurde.

Handelt es sich bei der Datei um einen Symlink, gibt diese Funktion Informationen über das Ziel zurück, nicht über den Symlink.

Siehe auch „ ownerId()“, „ group()“ und „ groupId()“.

uint QFileInfo::ownerId() const

Gibt die ID des Eigentümers der Datei zurück.

Unter Windows und auf Systemen, auf denen Dateien keine Eigentümer haben, gibt diese Funktion ((uint) -2) zurück.

Handelt es sich bei der Datei um einen Symlink, gibt diese Funktion Informationen über das Ziel zurück, nicht über den Symlink.

Siehe auch owner(), group() und groupId().

QString QFileInfo::path() const

Gibt den Pfad des Dateisystem-Eintrags zurück, auf den sich dieser QFileInfo bezieht, ohne den Namen des Eintrags.

Siehe auch filePath(), absolutePath(), canonicalPath(), dir(), fileName() und isRelative().

bool QFileInfo::permission(QFileDevice::Permissions permissions) const

Prüft Dateiberechtigungen. Das Argument „ permissions “ kann aus mehreren Flags vom Typ „QFile::Permissions“ bestehen, die mit dem OR-Operator verknüpft sind, um verschiedene Berechtigungskombinationen zu prüfen.

Auf Systemen, auf denen Dateien keine Berechtigungen haben, gibt diese Funktion immer ` true` zurück.

Beispiel:

QFileInfo fi("/tmp/archive.tar.gz");
if (fi.permission(QFile::WriteUser | QFile::ReadGroup))
    qWarning("I can change the file; my group can read the file");
if (fi.permission(QFile::WriteGroup | QFile::WriteOther))
    qWarning("The group or others can change the file");

Wenn es sich bei der Datei um einen symbolischen Link handelt, gibt diese Funktion Informationen über das Ziel zurück, nicht über den symbolischen Link.

Siehe auch isReadable(), isWritable() und isExecutable().

QFileDevice::Permissions QFileInfo::permissions() const

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

Handelt es sich bei der Datei um einen Symlink, gibt diese Funktion Informationen über das Ziel zurück, nicht über den Symlink selbst.

[since 6.6] QString QFileInfo::readSymLink() const

Liest den Pfad, auf den der symbolische Link verweist.

Gibt den Rohpfad zurück, auf den der symbolische Link verweist, ohne einen relativen Pfad relativ zum Verzeichnis, das den symbolischen Link enthält, aufzulösen. Die zurückgegebene Zeichenkette ist nur dann ein absoluter Pfad, wenn der symbolische Link tatsächlich als solcher darauf verweist. Gibt eine leere Zeichenkette zurück, wenn das Objekt kein symbolischer Link ist.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch symLinkTarget(), exists(), isSymLink(), isDir() und isFile().

void QFileInfo::refresh()

Aktualisiert die Informationen zu dem Dateisystemeintrag, auf den sich „ QFileInfo “ bezieht, d. h., es werden beim nächsten Abruf einer zwischengespeicherten Eigenschaft Informationen aus dem Dateisystem eingelesen.

void QFileInfo::setCaching(bool enable)

Wenn „ enable “ auf „true“ gesetzt ist, wird das Zwischenspeichern von Dateiinformationen aktiviert. Ist „ enable “ auf „false“ gesetzt, ist das Zwischenspeichern deaktiviert.

Wenn die Zwischenspeicherung aktiviert ist, liest „ QFileInfo “ die Dateiinformationen beim ersten Bedarf aus dem Dateisystem, danach jedoch in der Regel nicht mehr.

Das Caching ist standardmäßig aktiviert.

Siehe auch ` refresh()` und ` caching()`.

void QFileInfo::setFile(const QString &path)

Legt den Pfad des Dateisystem-Eintrags fest, zu dem dieser QFileInfo Informationen bereitstellt, und zwar unter path; dieser Pfad kann absolut oder relativ sein.

Unter Unix beginnen absolute Pfade mit dem Verzeichnistrennzeichen „ '/' “. Unter Windows beginnen absolute Pfade mit einer Laufwerksangabe (zum Beispiel „ D:/ “).

Relative Pfade beginnen mit einem Verzeichnisnamen oder einem regulären Dateinamen und geben den Pfad eines Dateisystemeintrags relativ zum aktuellen Arbeitsverzeichnis an.

Beispiel:

QFileInfo info("/usr/bin/env");

QString path = info.absolutePath(); // path = /usr/bin
QString base = info.baseName(); // base = env

info.setFile("/etc/hosts");

path = info.absolutePath(); // path = /etc
base = info.baseName(); // base = hosts

Siehe auch isFile(), isRelative(), QDir::setCurrent() und QDir::isRelativePath().

[since 6.0] void QFileInfo::setFile(const std::filesystem::path &path)

Legt den Pfad des Dateisystem-Eintrags fest, zu dem diese QFileInfo Informationen bereitstellt, auf path.

Ist „ path “ relativ, hat „ QFileInfo “ ebenfalls einen relativen Pfad.

Diese Funktion wurde in Qt 6.0 eingeführt.

void QFileInfo::setFile(const QFileDevice &file)

Legt die Datei, zu der die „ QFileInfo “ Informationen bereitstellt, auf „ file “ fest.

Wenn „ file “ einen relativen Pfad enthält, hat „ QFileInfo “ ebenfalls einen relativen Pfad.

Siehe auch isRelative().

void QFileInfo::setFile(const QDir &dir, const QString &path)

Legt den Pfad des Dateisystem-Eintrags fest, zu dem dieser „ QFileInfo “ Informationen bereitstellt, und zwar unter „ path “ im Verzeichnis „ dir “.

Wenn „ dir “ einen relativen Pfad hat, hat „ QFileInfo “ ebenfalls einen relativen Pfad.

Ist path absolut, wird das durch dir angegebene Verzeichnis ignoriert.

Siehe auch isRelative().

qint64 QFileInfo::size() const

Gibt die Dateigröße in Byte zurück. Wenn die Datei nicht existiert oder nicht abgerufen werden kann, wird 0 zurückgegeben.

Wenn es sich bei der Datei um einen Symlink handelt, gibt diese Funktion Informationen über das Ziel zurück, nicht über den Symlink.

Siehe auch ` exists()`.

[since 6.0] void QFileInfo::stat()

Liest alle Attribute aus dem Dateisystem.

Dies ist nützlich, wenn Informationen über das Dateisystem in einem Worker-Thread gesammelt und anschließend in Form von zwischengespeicherten ` QFileInfo `-Instanzen an die Benutzeroberfläche übergeben werden.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` setCaching()` und ` refresh()`.

QString QFileInfo::suffix() const

Gibt die Dateiendung der Datei zurück.

Die Dateiendung besteht aus allen Zeichen in der Datei nach dem letzten „.“ (dieses selbst ausgenommen).

Beispiel:

QFileInfo fi("/tmp/archive.tar.gz");
QString ext = fi.suffix();  // ext = "gz"

Das Suffix einer Datei wird auf allen Plattformen einheitlich berechnet, unabhängig von Dateinamenskonventionen (z. B. hat „.bashrc“ unter Unix einen leeren Basisnamen, und das Suffix lautet „bashrc“).

Siehe auch fileName(), completeSuffix(), baseName() und completeBaseName().

[noexcept] void QFileInfo::swap(QFileInfo &other)

Tauscht die Informationen dieser Datei mit denen unter other aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

QString QFileInfo::symLinkTarget() const

Gibt den absoluten Pfad zu der Datei oder dem Verzeichnis zurück, auf die bzw. das ein symbolischer Link verweist, oder eine leere Zeichenkette, wenn es sich bei dem Objekt nicht um einen symbolischen Link handelt.

Dieser Name muss nicht unbedingt eine existierende Datei bezeichnen; es handelt sich lediglich um eine Zeichenkette.

Siehe auch exists(), isSymLink(), isDir() und isFile().

[noexcept] QFileInfo &QFileInfo::operator=(QFileInfo &&other)

Weist „ other “ dieser Instanz von „ QFileInfo “ zu.

QFileInfo &QFileInfo::operator=(const QFileInfo &fileinfo)

Erstellt eine Kopie des angegebenen fileinfo und weist sie diesem QFileInfo zu.