QDir Class

Dokumentation der Mitgliedsfunktionen

QDir::QDir(const QString &path = QString())

Erstellt ein QDir, das auf das angegebene Verzeichnis path verweist. Ist path leer, wird das Arbeitsverzeichnis des Programms („.“) verwendet.

Siehe auch currentPath().

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

Erstellt ein QDir, das auf das angegebene Verzeichnis path verweist. Ist path leer, wird das Arbeitsverzeichnis des Programms („.“) verwendet.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch currentPath().

QDir::QDir(const QString &path, const QString &nameFilter, QDir::SortFlags sort = SortFlags(Name | IgnoreCase), QDir::Filters filters = AllEntries)

Erstellt ein QDir mit dem Pfad „ path “, das seine Einträge anhand des Namens unter Verwendung von „ nameFilter “ und anhand von Attributen unter Verwendung von „ filters “ filtert. Außerdem sortiert es die Namen unter Verwendung von „ sort “.

Der Standardwert für ` nameFilter ` ist eine leere Zeichenkette, wodurch nichts ausgeschlossen wird; der Standardwert für ` filters ` ist ` AllEntries`, wodurch ebenfalls nichts ausgeschlossen wird. Der Standardwert für ` sort ` ist ` Name | IgnoreCase`, d. h. Sortierung nach Namen ohne Berücksichtigung der Groß-/Kleinschreibung.

Wenn path eine leere Zeichenkette ist, verwendet QDir „.“ (das aktuelle Verzeichnis). Wenn nameFilter eine leere Zeichenkette ist, verwendet QDir den Namensfilter „*“ (alle Dateien).

Siehe auch exists(), setPath(), setNameFilters(), setFilter() und setSorting().

[since 6.0] QDir::QDir(const std::filesystem::path &path, const QString &nameFilter, QDir::SortFlags sort = SortFlags(Name | IgnoreCase), QDir::Filters filters = AllEntries)

Erstellt ein QDir mit dem Pfad „ path “, das seine Einträge anhand des Namens unter Verwendung von „ nameFilter “ und anhand von Attributen unter Verwendung von „ filters “ filtert. Außerdem sortiert es die Namen unter Verwendung von „ sort “.

Der Standardwert für ` nameFilter ` ist eine leere Zeichenkette, wodurch nichts ausgeschlossen wird; der Standardwert für ` filters ` ist ` AllEntries`, wodurch ebenfalls nichts ausgeschlossen wird. Der Standardwert für ` sort ` ist ` Name | IgnoreCase`, d. h. Sortierung nach Namen ohne Berücksichtigung der Groß-/Kleinschreibung.

Ist path leer, verwendet QDir „.“ (das aktuelle Verzeichnis). Ist nameFilter eine leere Zeichenkette, verwendet QDir den Namensfilter „*“ (alle Dateien).

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch „ exists()“, „ setPath()“, „ setNameFilters()“, „ setFilter()“ und „ setSorting()“.

QDir::QDir(const QDir &dir)

Erstellt ein QDir-Objekt, das eine Kopie des QDir-Objekts für das Verzeichnis dir ist.

Siehe auch operator=().

[noexcept] QDir::~QDir()

Löscht das „ QDir “-Objekt und gibt dessen Ressourcen frei. Dies hat keine Auswirkungen auf das zugrunde liegende Verzeichnis im Dateisystem.

QString QDir::absoluteFilePath(const QString &fileName) const

Gibt den absoluten Pfadnamen einer Datei im Verzeichnis zurück. Es wird nicht geprüft, ob die Datei tatsächlich im Verzeichnis vorhanden ist; siehe jedoch exists(). Überflüssige Mehrfachtrennzeichen oder „.“- und „..“-Verzeichnisse in fileName werden nicht entfernt (siehe cleanPath()).

Siehe auch relativeFilePath(), filePath() und canonicalPath().

QString QDir::absolutePath() const

Gibt den absoluten Pfad zurück (einen Pfad, der mit „/“ oder einer Laufwerksangabe beginnt), der symbolische Links enthalten kann, jedoch niemals überflüssige „.“, „..“ oder mehrere Trennzeichen enthält.

Siehe auch setPath(), canonicalPath(), exists(), cleanPath(), dirName() und absoluteFilePath().

[static] void QDir::addSearchPath(const QString &prefix, const QString &path)

Fügt „ path “ zum Suchpfad für „ prefix “ hinzu.

Siehe auch setSearchPaths().

[static, since 6.0] void QDir::addSearchPath(const QString &prefix, const std::filesystem::path &path)

Diese Funktion wurde in Qt 6.0 eingeführt.

QString QDir::canonicalPath() const

Gibt den kanonischen Pfad zurück, d. h. einen Pfad ohne symbolische Links oder überflüssige „.“- oder „..“-Elemente.

Auf Systemen ohne symbolische Links gibt diese Funktion immer denselben String zurück wie absolutePath(). Diese Methode gibt eine leere Zeichenkette zurück, wenn der Eintrag nicht existiert, nicht erreichbar ist (z. B. weil der aktuelle Benutzer keinen Zugriff auf einen Verzeichnispfad hat) oder wenn beim Kanonisieren des Pfads ein Fehler auftritt (normalerweise aufgrund hängender symbolischer Links).

Beispiel:

QString bin = "/local/bin";         // where /local/bin is a symlink to /usr/bin
QDir binDir(bin);
QString canonicalBin = binDir.canonicalPath();
// canonicalBin now equals "/usr/bin"

QString ls = "/local/bin/ls";       // where ls is the executable "ls"
QDir lsDir(ls);
QString canonicalLs = lsDir.canonicalPath();
// canonicalLS now equals "/usr/bin/ls".

Siehe auch path(), absolutePath(), exists(), cleanPath(), dirName() und absoluteFilePath().

bool QDir::cd(const QString &dirName)

Wechselt das Verzeichnis von „ QDir “ zu „ dirName “.

Gibt „ true “ zurück, wenn das neue Verzeichnis existiert; andernfalls wird „ false “ zurückgegeben. Beachten Sie, dass die logische cd()-Operation nicht ausgeführt wird, wenn das neue Verzeichnis nicht existiert.

Der Aufruf von `cd("..")` entspricht dem Aufruf von ` cdUp()`.

Siehe auch cdUp(), isReadable(), exists() und path().

bool QDir::cdUp()

Wechselt das Verzeichnis, indem vom aktuellen Verzeichnis des „ QDir “ ein Verzeichnis nach oben gewechselt wird.

Gibt „ true “ zurück, wenn das neue Verzeichnis existiert; andernfalls wird „ false “ zurückgegeben. Beachten Sie, dass die logische Operation „cdUp()“ nicht ausgeführt wird, wenn das neue Verzeichnis nicht existiert.

Siehe auch „ cd()“, „ isReadable()“, „ exists()“ und „ path()“.

[static] QString QDir::cleanPath(const QString &path)

Gibt ` path ` zurück, wobei Verzeichnis-Trennzeichen normalisiert (d. h. plattformspezifische Trennzeichen werden in „/“ umgewandelt) und überflüssige entfernt sowie „.“ und „..“ (soweit möglich) aufgelöst werden.

Symbolische Links bleiben erhalten. Diese Funktion gibt nicht den kanonischen Pfad zurück, sondern die einfachste Version der Eingabe. Beispielsweise wird „./local“ zu „local“, „local/../bin“ zu „bin“ und „/local/usr/../bin“ zu „/local/bin“.

Siehe auch absolutePath() und canonicalPath().

qsizetype QDir::count() const

Gibt die Gesamtzahl der Verzeichnisse und Dateien im Verzeichnis zurück.

Entspricht ` entryList()`.count().

Siehe auch „ operator[]()“ und „ entryList()“.

[static] QDir QDir::current()

Gibt das aktuelle Verzeichnis der Anwendung zurück.

Das Verzeichnis wird anhand des absoluten Pfads des aktuellen Verzeichnisses gebildet, wodurch sichergestellt wird, dass die Funktion „ path()“ dasselbe Ergebnis liefert wie „ absolutePath()“.

Siehe auch ` currentPath()`, ` setCurrent()`, ` home()`, ` root()` und ` temp()`.

[static] QString QDir::currentPath()

Gibt den absoluten Pfad des aktuellen Verzeichnisses der Anwendung zurück. Das aktuelle Verzeichnis ist das zuletzt mit ` QDir::setCurrent()` festgelegte Verzeichnis oder, falls diese Funktion nie aufgerufen wurde, das Verzeichnis, in dem diese Anwendung vom übergeordneten Prozess gestartet wurde.

Siehe auch ` current()`, ` setCurrent()`, ` homePath()`, ` rootPath()`, ` tempPath()` und ` QCoreApplication::applicationDirPath()`.

QString QDir::dirName() const

Gibt den Namen des Verzeichnisses zurück; dieser ist nicht mit dem Pfad identisch. So könnte beispielsweise ein Verzeichnis mit dem Namen „mail“ den Pfad „/var/spool/mail“ haben. Wenn das Verzeichnis keinen Namen hat (z. B. wenn es sich um das Stammverzeichnis handelt), wird eine leere Zeichenkette zurückgegeben.

Es wird nicht überprüft, ob ein Verzeichnis mit diesem Namen tatsächlich existiert; siehe jedoch exists().

Siehe auch path(), filePath(), absolutePath() und absoluteFilePath().

[static] QFileInfoList QDir::drives()

Gibt eine Liste der Stammverzeichnisse auf diesem System zurück.

Unter Windows gibt diese Funktion eine Liste von „ QFileInfo “-Objekten zurück, die „C:/“, „D:/“ usw. enthalten. Laufwerke mit herausnehmbaren Medien, die leer sind, werden dabei nicht zurückgegeben. Auf anderen Betriebssystemen gibt die Funktion eine Liste zurück, die nur ein Stammverzeichnis enthält (d. h. „/“).

Siehe auch „ root()“ und „ rootPath()“.

QFileInfoList QDir::entryInfoList(const QStringList &nameFilters, QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) const

Gibt eine Liste von „ QFileInfo “-Objekten für alle Dateien und Verzeichnisse im Verzeichnis zurück, geordnet nach den zuvor mit ` setNameFilters()` und ` setFilter()` festgelegten Namens- und Attributfiltern sowie sortiert nach den mit ` setSorting()` festgelegten Flags.

Der Namensfilter, der Dateiattributfilter und die Sortierspezifikation können mithilfe der Argumente ` nameFilters`, ` filters` und ` sort ` überschrieben werden.

Gibt eine leere Liste zurück, wenn das Verzeichnis nicht lesbar ist, nicht existiert oder wenn keine Einträge der Spezifikation entsprechen.

Bei großen Verzeichnissen kann diese Funktion einen kurzzeitigen Speicheranstieg verursachen, da für jeden Eintrag im Verzeichnis eine Instanz von ` QFileInfo ` erstellt wird. Ziehen Sie die Verwendung von ` QDirListing ` in Betracht, wenn Sie die Elemente einzeln durchlaufen möchten.

Siehe auch entryList(), setNameFilters(), setSorting(), setFilter(), isReadable() und exists().

QFileInfoList QDir::entryInfoList(QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) const

Gibt eine Liste von „ QFileInfo “-Objekten für alle Dateien und Verzeichnisse im Verzeichnis zurück, sortiert nach den zuvor mit „ setNameFilters()“ und „ setFilter()“ festgelegten Namens- und Attributfiltern sowie nach den mit „ setSorting()“ festgelegten Flags.

Die Attributfilter und Sortierspezifikationen können mithilfe der Argumente ` filters ` und ` sort ` überschrieben werden.

Gibt eine leere Liste zurück, wenn das Verzeichnis nicht lesbar ist, nicht existiert oder wenn keine Einträge der Spezifikation entsprechen.

Bei großen Verzeichnissen kann diese Funktion zu einem kurzzeitigen Anstieg des Speicherbedarfs führen, da sie für jeden Eintrag im Verzeichnis eine Instanz von ` QFileInfo ` erstellt. Ziehen Sie die Verwendung von ` QDirListing ` in Betracht, wenn Sie die Elemente einzeln durchlaufen möchten.

Siehe auch entryList(), setNameFilters(), setSorting(), setFilter(), isReadable() und exists().

QStringList QDir::entryList(const QStringList &nameFilters, QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) const

Gibt eine Liste der Namen aller Dateien und Verzeichnisse im Verzeichnis zurück, geordnet nach den zuvor mit ` setNameFilters()` und ` setFilter()` festgelegten Namens- und Attributfiltern und sortiert nach den mit ` setSorting()` festgelegten Flags.

Der Namensfilter, der Dateiattributfilter und die Sortierspezifikation können mithilfe der Argumente ` nameFilters`, ` filters` und ` sort ` überschrieben werden.

Gibt eine leere Liste zurück, wenn das Verzeichnis nicht lesbar ist, nicht existiert oder wenn keine Einträge der Spezifikation entsprechen.

Bei großen Verzeichnissen kann diese Funktion zu einem kurzzeitigen Anstieg des Speicherbedarfs führen, da sie für jeden Eintrag im Verzeichnis eine Instanz von ` QString ` erstellt. Ziehen Sie die Verwendung von ` QDirListing ` in Betracht, wenn Sie die Elemente nacheinander durchlaufen möchten.

Siehe auch entryInfoList(), setNameFilters(), setSorting() und setFilter().

QStringList QDir::entryList(QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) const

Gibt eine Liste der Namen aller Dateien und Verzeichnisse im Verzeichnis zurück, geordnet nach den zuvor mit ` setNameFilters()` und ` setFilter()` festgelegten Namens- und Attributfiltern und sortiert nach den mit ` setSorting()` festgelegten Flags.

Die Attributfilter und Sortierspezifikationen können mithilfe der Argumente ` filters ` und ` sort ` überschrieben werden.

Gibt eine leere Liste zurück, wenn das Verzeichnis nicht lesbar ist, nicht existiert oder wenn keine Einträge der Spezifikation entsprechen.

Bei großen Verzeichnissen kann diese Funktion zu einem kurzzeitigen Anstieg des Speicherbedarfs führen, da sie für jeden Eintrag im Verzeichnis eine Instanz von ` QString ` erstellt. Ziehen Sie die Verwendung von ` QDirListing ` in Betracht, wenn Sie die Elemente einzeln durchlaufen möchten.

Siehe auch entryInfoList(), setNameFilters(), setSorting() und setFilter().

bool QDir::exists(const QString &name) const

Gibt „ true “ zurück, wenn die Datei „ name “ existiert; andernfalls wird „false“ zurückgegeben.

Sofern ` name ` keinen absoluten Dateipfad enthält, wird davon ausgegangen, dass der Dateiname relativ zum Verzeichnis selbst ist; daher wird diese Funktion in der Regel verwendet, um zu prüfen, ob Dateien in einem Verzeichnis vorhanden sind.

Siehe auch QFileInfo::exists() und QFile::exists().

bool QDir::exists() const

Gibt „ true “ zurück, wenn das Verzeichnis existiert; andernfalls wird „ false “ zurückgegeben. (Wird eine Datei mit demselben Namen gefunden, gibt diese Funktion „false“ zurück.)

Die Überladung dieser Funktion, die ein Argument akzeptiert, wird verwendet, um das Vorhandensein von Dateien und Verzeichnissen innerhalb eines Verzeichnisses zu prüfen.

Siehe auch „ QFileInfo::exists()“ und „ QFile::exists()“.

QString QDir::filePath(const QString &fileName) const

Gibt den Pfadnamen einer Datei im Verzeichnis zurück. Es wird nicht geprüft, ob die Datei tatsächlich im Verzeichnis vorhanden ist; siehe jedoch exists(). Ist der QDir relativ, ist auch der zurückgegebene Pfadname relativ. Überflüssige Mehrfachtrennzeichen oder „.“- und „..“-Verzeichnisse in fileName werden nicht entfernt (siehe cleanPath()).

Siehe auch dirName(), absoluteFilePath(), isRelative() und canonicalPath().

[since 6.0] std::filesystem::path QDir::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 QDir::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 QDir::filesystemPath() const

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

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` path()`.

QDir::Filters QDir::filter() const

Gibt den durch setFilter() festgelegten Wert zurück

Siehe auch ` setFilter()`.

[static] QString QDir::fromNativeSeparators(const QString &pathName)

Gibt „ pathName “ zurück, wobei „/“ als Dateitrennzeichen verwendet wird. Unter Windows liefert beispielsweise fromNativeSeparators(„c:\\winnt\\system32 “) den Wert „c:/winnt/system32“ zurück.

Die zurückgegebene Zeichenkette kann auf einigen Betriebssystemen, beispielsweise unter Unix, mit dem Argument übereinstimmen.

Siehe auch ` toNativeSeparators()` und ` separator()`.

[static] QDir QDir::home()

Gibt das Home-Verzeichnis des Benutzers zurück.

Das Verzeichnis wird unter Verwendung des absoluten Pfads des Home-Verzeichnisses gebildet, wodurch sichergestellt wird, dass seine Funktion „ path()“ dieselben Ergebnisse liefert wie „ absolutePath()“.

Weitere Informationen finden Sie unter ` homePath()`.

Siehe auch drives(), current(), root() und temp().

[static] QString QDir::homePath()

Gibt den absoluten Pfad zum Home-Verzeichnis des Benutzers zurück.

Unter Windows gibt diese Funktion das Verzeichnis des Profils des aktuellen Benutzers zurück. In der Regel lautet dieses:

C:/Users/Username

Verwenden Sie die Funktion ` toNativeSeparators()` (), um die Trennzeichen in die für das jeweilige Betriebssystem geeigneten Zeichen umzuwandeln.

Wenn das Profilverzeichnis des aktuellen Benutzers nicht existiert oder nicht abgerufen werden kann, werden die folgenden Alternativen (in der angegebenen Reihenfolge) geprüft, bis ein vorhandener und verfügbarer Pfad gefunden wird:

1. Der durch die Umgebungsvariable ` USERPROFILE ` angegebene Pfad.
2. Der Pfad, der durch Verknüpfung der Umgebungsvariablen ` HOMEDRIVE ` und ` HOMEPATH ` gebildet wird.
3. Der durch die Umgebungsvariable ` HOME ` angegebene Pfad.
4. Der von der Funktion ` rootPath()` zurückgegebene Pfad (die die Umgebungsvariable ` SystemDrive ` verwendet)
5. Das Verzeichnis „ C:/ “.

Unter anderen Betriebssystemen als Windows wird die Umgebungsvariable „ HOME “ verwendet, sofern sie vorhanden ist; andernfalls wird der von „ rootPath()“ zurückgegebene Pfad verwendet.

Siehe auch „ home()“, „ currentPath()“, „ rootPath()“ und „ tempPath()“.

bool QDir::isAbsolute() const

Gibt „ true “ zurück, wenn der Pfad des Verzeichnisses absolut ist; andernfalls wird „ false “ zurückgegeben. Siehe isAbsolutePath().

Siehe auch isRelative(), makeAbsolute() und cleanPath().

[static] bool QDir::isAbsolutePath(const QString &path)

Gibt „ true “ zurück, wenn „ path “ ein absoluter Pfad ist; gibt „ false “ zurück, wenn es sich um einen relativen Pfad handelt.

Siehe auch isAbsolute(), isRelativePath(), makeAbsolute(), cleanPath() und QResource.

bool QDir::isEmpty(QDir::Filters filters = Filters(AllEntries | NoDotAndDotDot)) const

Gibt zurück, ob das Verzeichnis leer ist.

Entspricht ` count() == 0 ` mit den Filtern ` QDir::AllEntries | QDir::NoDotAndDotDot`, ist jedoch schneller, da lediglich geprüft wird, ob das Verzeichnis mindestens einen Eintrag enthält.

Siehe auch count(), entryList() und setFilter().

bool QDir::isReadable() const

Gibt „ true “ zurück, wenn das Verzeichnis lesbar ist und Dateien anhand ihres Namens geöffnet werden können; andernfalls wird „ false “ zurückgegeben.

Siehe auch QFileInfo::isReadable().

bool QDir::isRelative() const

Gibt „ true “ zurück, wenn der Verzeichnispfad relativ ist; andernfalls wird „false“ zurückgegeben. (Unter Unix ist ein Pfad relativ, wenn er nicht mit einem „/“ beginnt).

Siehe auch makeAbsolute(), isAbsolute(), isAbsolutePath() und cleanPath().

[static] bool QDir::isRelativePath(const QString &path)

Gibt „ true “ zurück, wenn „ path “ relativ ist; gibt „ false “ zurück, wenn es absolut ist.

Siehe auch isRelative(), isAbsolutePath() und makeAbsolute().

bool QDir::isRoot() const

Gibt „ true “ zurück, wenn es sich bei dem Verzeichnis um das Stammverzeichnis handelt; andernfalls wird „ false “ zurückgegeben.

QDir dir("/tmp/root_link");
dir = dir.canonicalPath();
if (dir.isRoot())
    qWarning("It is a root link");

Siehe auch root() und rootPath().

[static constexpr noexcept] QChar QDir::listSeparator()

Gibt das systemeigene Trennzeichen für Pfadlisten zurück: „:“ unter Unix und „;“ unter Windows.

Siehe auch separator().

bool QDir::makeAbsolute()

Wandelt den Verzeichnispfad in einen absoluten Pfad um. Ist der Pfad bereits absolut, geschieht nichts. Gibt „ true “ zurück, wenn die Umwandlung erfolgreich war; andernfalls wird „ false “ zurückgegeben.

Siehe auch isAbsolute(), isAbsolutePath(), isRelative() und cleanPath().

[static] bool QDir::match(const QString &filter, const QString &fileName)

Gibt „ true “ zurück, wenn die „ fileName “ mit dem Platzhaltermuster (Glob) „ filter “ übereinstimmt; andernfalls wird „ false “ zurückgegeben. Die „ filter “ kann mehrere Muster enthalten, die durch Leerzeichen oder Semikolons getrennt sind. Bei der Übereinstimmungsprüfung wird die Groß-/Kleinschreibung nicht berücksichtigt.

Siehe auch „ QRegularExpression::fromWildcard()“, „ entryList()“ und „ entryInfoList()“.

[static] bool QDir::match(const QStringList &filters, const QString &fileName)

Gibt „ true “ zurück, wenn „ fileName “ mit einem der Platzhaltermuster (Glob-Muster) in der Liste „ filters “ übereinstimmt; andernfalls wird „ false “ zurückgegeben. Bei der Übereinstimmungsprüfung wird die Groß-/Kleinschreibung nicht berücksichtigt.

Siehe auch QRegularExpression::fromWildcard(), entryList() und entryInfoList().

bool QDir::mkdir(const QString &dirName, std::optional<QFileDevice::Permissions> permissions = std::nullopt) const

Erstellt ein Unterverzeichnis namens „ dirName “ mit dem angegebenen „ permissions “.

Wenn „ permissions “ gleich „ std::nullopt “ ist (Standard), legt diese Funktion die Standardberechtigungen fest.

Gibt bei Erfolg „ true “ zurück; gibt „ false “ zurück, wenn der Vorgang fehlgeschlagen ist oder „ dirName “ bereits existierte.

Falls „ dirName “ bereits existierte, ändert diese Methode dessen Berechtigungen nicht.

Auf POSIX-Systemen werden die Berechtigungen von „ permissions “ durch die umask (Datei-Erstellungsmaske) des aktuellen Prozesses geändert, was bedeutet, dass einige Berechtigungsbits möglicherweise deaktiviert sind.

Unter Windows erbt ein neues Verzeichnis standardmäßig die Berechtigungen seines übergeordneten Verzeichnisses. „ permissions “ werden mithilfe von ACLs emuliert. Diese ACLs können in nicht-kanonischer Reihenfolge vorliegen, wenn der Gruppe weniger Berechtigungen gewährt werden als anderen. Dateien und Verzeichnisse mit solchen Berechtigungen lösen Warnungen aus, wenn die Registerkarte „Sicherheit“ des Eigenschaftsdialogs geöffnet wird. Durch die Vergabe aller Berechtigungen, die anderen gewährt werden, an die Gruppe lassen sich solche Warnungen vermeiden.

Siehe auch „ rmdir()“, „ mkpath()“ und „ rmpath()“.

bool QDir::mkpath(const QString &dirPath, std::optional<QFileDevice::Permissions> permissions = std::nullopt) const

Erstellt ein Verzeichnis mit dem Namen „ dirPath “.

Falls „ dirPath “ noch nicht existiert, erstellt diese Methode das Verzeichnis – zusammen mit allen nicht vorhandenen übergeordneten Verzeichnissen – mit „ permissions “.

Falls „ dirPath “ bereits existiert, ändert diese Methode die Berechtigungen nicht; dasselbe gilt für bereits vorhandene übergeordnete Verzeichnisse.

Ist „ permissions “ gleich „ std::nullopt “ (der Standardwert), setzt diese Funktion die Standardberechtigungen.

Gibt bei Erfolg oder falls „ dirPath “ bereits existiert „ true “ zurück; andernfalls wird „ false “ zurückgegeben.

Auf POSIX-Systemen werden ` permissions ` durch die umask (Dateierstellungsmaske) des aktuellen Prozesses, was bedeutet, dass einige Berechtigungsbits möglicherweise deaktiviert sind.

Unter Windows erbt ein neues Verzeichnis standardmäßig die Berechtigungen seines übergeordneten Verzeichnisses. „ permissions “ werden mithilfe von ACLs emuliert. Diese ACLs können in nicht-kanonischer Reihenfolge vorliegen, wenn der Gruppe weniger Berechtigungen gewährt werden als anderen. Dateien und Verzeichnisse mit solchen Berechtigungen lösen Warnungen aus, wenn die Registerkarte „Sicherheit“ des Eigenschaften-Dialogfelds geöffnet wird. Durch die Gewährung aller Berechtigungen, die anderen gewährt wurden, an die Gruppe lassen sich solche Warnungen vermeiden.

Siehe auch rmpath(), mkdir() und rmdir().

QStringList QDir::nameFilters() const

Gibt die mit setNameFilters() festgelegte Zeichenfolgenliste zurück

Siehe auch ` setNameFilters()`.

QString QDir::path() const

Gibt den Pfad zurück. Dieser kann symbolische Verknüpfungen enthalten, enthält jedoch niemals überflüssige „.“, „..“ oder mehrere Trennzeichen.

Der zurückgegebene Pfad kann entweder absolut oder relativ sein (siehe setPath()).

Siehe auch setPath(), absolutePath(), exists(), cleanPath(), dirName(), absoluteFilePath(), toNativeSeparators() und makeAbsolute().

void QDir::refresh() const

Aktualisiert die Verzeichnisinformationen.

QString QDir::relativeFilePath(const QString &fileName) const

Gibt den Pfad zu fileName relativ zum Verzeichnis zurück.

QDir dir("/home/bob");
QString s;

s = dir.relativeFilePath("images/file.jpg");     // s is "images/file.jpg"
s = dir.relativeFilePath("/home/mary/file.txt"); // s is "../mary/file.txt"

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

bool QDir::remove(const QString &fileName)

Löscht die Datei „ fileName “.

Gibt „ true “ zurück, wenn die Datei erfolgreich entfernt wurde; andernfalls wird „ false “ zurückgegeben.

bool QDir::removeRecursively()

Löscht das Verzeichnis einschließlich seines gesamten Inhalts.

Gibt bei Erfolg „ true “ zurück, andernfalls „false“.

Wenn eine Datei oder ein Verzeichnis nicht entfernt werden kann, setzt removeRecursively() den Vorgang fort und versucht, so viele Dateien und Unterverzeichnisse wie möglich zu löschen; anschließend gibt die Methode „ false “ zurück.

Wurde das Verzeichnis bereits entfernt, gibt die Methode „ true “ zurück (erwartetes Ergebnis bereits erreicht).

bool QDir::rename(const QString &oldName, const QString &newName)

Benennt eine Datei oder ein Verzeichnis von „ oldName “ in „ newName “ um und gibt bei Erfolg „true“ zurück; andernfalls wird „ false “ zurückgegeben.

Auf den meisten Dateisystemen schlägt rename() nur dann fehl, wenn „ oldName “ nicht existiert oder wenn bereits eine Datei mit dem neuen Namen vorhanden ist. Es gibt jedoch auch andere Gründe, warum rename() fehlschlagen kann. Beispielsweise schlägt rename() auf mindestens einem Dateisystem fehl, wenn „ newName “ auf eine geöffnete Datei verweist.

Wenn oldName eine Datei (kein Verzeichnis) ist, die nicht sofort umbenannt werden kann, versucht Qt, oldName nach newName zu kopieren und oldName zu entfernen.

Siehe auch QFile::rename().

bool QDir::rmdir(const QString &dirName) const

Löscht das durch ` dirName` angegebene Verzeichnis.

Das Verzeichnis muss leer sein, damit rmdir() erfolgreich ausgeführt werden kann.

Gibt bei Erfolg true zurück; andernfalls wird false zurückgegeben.

Siehe auch mkdir().

bool QDir::rmpath(const QString &dirPath) const

Entfernt den Verzeichnispfad „ dirPath “.

Die Funktion entfernt alle übergeordneten Verzeichnisse in „ dirPath “, sofern diese leer sind. Dies ist das Gegenteil von „mkpath(dirPath)“.

Gibt bei Erfolg „ true “ zurück; andernfalls „ false “.

Siehe auch mkpath().

[static] QDir QDir::root()

Gibt das Stammverzeichnis zurück.

Das Verzeichnis wird anhand des absoluten Pfads des Stammverzeichnisses erstellt, wodurch sichergestellt wird, dass die Funktion „ path()“ dasselbe Ergebnis liefert wie „ absolutePath()“.

Weitere Informationen finden Sie unter ` rootPath()`.

Siehe auch drives(), current(), home() und temp().

[static] QString QDir::rootPath()

Gibt den absoluten Pfad des Stammverzeichnisses zurück.

Bei Unix-Betriebssystemen wird „/“ zurückgegeben. Bei Windows-Dateisystemen wird normalerweise „c:/“ zurückgegeben.

Siehe auch root(), drives(), currentPath(), homePath() und tempPath().

[static] QStringList QDir::searchPaths(const QString &prefix)

Gibt die Suchpfade für prefix zurück.

Siehe auch setSearchPaths() und addSearchPath().

[static] QChar QDir::separator()

Gibt das native Verzeichnistrennzeichen zurück: „/“ unter Unix und „\“ unter Windows.

Sie müssen diese Funktion nicht zum Erstellen von Dateipfaden verwenden. Wenn Sie stets „/“ verwenden, passt Qt Ihre Pfade an das jeweilige Betriebssystem an. Wenn Sie dem Benutzer Pfade mit dem Trennzeichen seines Betriebssystems anzeigen möchten, verwenden Sie toNativeSeparators().

Siehe auch ` listSeparator()`.

[static] bool QDir::setCurrent(const QString &path)

Setzt das aktuelle Arbeitsverzeichnis der Anwendung auf path. Gibt true zurück, wenn das Verzeichnis erfolgreich geändert wurde; andernfalls wird false zurückgegeben.

QString absolute = "/local/bin";
QString relative = "local/bin";
QFileInfo absFile(absolute);
QFileInfo relFile(relative);

QDir::setCurrent(QDir::rootPath());
// absFile and relFile now point to the same file

QDir::setCurrent("/tmp");
// absFile now points to "/local/bin",
// while relFile points to "/tmp/local/bin"

Siehe auch current(), currentPath(), home(), root() und temp().

void QDir::setFilter(QDir::Filters filters)

Legt den von entryList() und entryInfoList() verwendeten Filter auf filters fest. Der Filter dient dazu, die Art der Dateien anzugeben, die von entryList() und entryInfoList() zurückgegeben werden sollen. Siehe QDir::Filter.

Siehe auch filter() und setNameFilters().

void QDir::setNameFilters(const QStringList &nameFilters)

Legt die von entryList() und entryInfoList() verwendeten Namensfilter auf die Liste der Filter fest, die durch nameFilters angegeben sind.

Jeder Namensfilter ist ein Platzhalterfilter (Globbing-Filter), der die Platzhalter von * und ? versteht. Siehe QRegularExpression::fromWildcard().

Der folgende Code legt beispielsweise drei Namensfilter für einen „ QDir “ fest, um sicherzustellen, dass nur Dateien mit den für C++-Quelldateien typischerweise verwendeten Dateiendungen aufgelistet werden:

    QStringList filters;
    filters << "*.cpp" << "*.cxx" << "*.cc";
    dir.setNameFilters(filters);

Siehe auch nameFilters() und setFilter().

void QDir::setPath(const QString &path)

Legt den Pfad des Verzeichnisses auf „ path “ fest. Der Pfad wird von überflüssigen „.“, „..“ und mehrfachen Trennzeichen bereinigt. Es wird nicht geprüft, ob ein Verzeichnis mit diesem Pfad tatsächlich existiert; Sie können dies jedoch selbst mit der Funktion „ exists()“ überprüfen.

Der Pfad kann entweder absolut oder relativ sein. Absolute Pfade beginnen mit dem Verzeichnistrennzeichen „/“ (unter Windows optional mit einer Laufwerksangabe davor). Relative Dateinamen beginnen mit einem Verzeichnisnamen oder einem Dateinamen und geben einen Pfad relativ zum aktuellen Verzeichnis an. Ein Beispiel für einen absoluten Pfad ist die Zeichenfolge „/tmp/quartz“, ein relativer Pfad könnte beispielsweise „src/fatlib“ lauten.

Siehe auch path(), absolutePath(), exists(), cleanPath(), dirName(), absoluteFilePath(), isRelative() und makeAbsolute().

[since 6.0] void QDir::setPath(const std::filesystem::path &path)

Diese Funktion wurde in Qt 6.0 eingeführt.

[static] void QDir::setSearchPaths(const QString &prefix, const QStringList &searchPaths)

Legt die Suchpfade von Qt für Dateinamen mit dem Präfix „ prefix “ fest oder ersetzt sie durch „ searchPaths “.

Um ein Präfix für einen Dateinamen anzugeben, stellen Sie das Präfix gefolgt von einem einzelnen Doppelpunkt voran (z. B. „images:undo.png“, „xmldocs:books.xml“). prefix darf nur Buchstaben oder Zahlen enthalten (z. B. darf es weder einen Doppelpunkt noch einen Schrägstrich enthalten).

Qt verwendet diesen Suchpfad, um Dateien mit einem bekannten Präfix zu finden. Die Einträge im Suchpfad werden der Reihe nach geprüft, beginnend mit dem ersten Eintrag.

QDir::setSearchPaths("icons", QStringList(QDir::homePath() + "/images"));
QDir::setSearchPaths("docs", QStringList(":/embeddedDocuments"));
//...
QPixmap pixmap("icons:undo.png"); // will look for undo.png in QDir::homePath() + "/images"
QFile file("docs:design.odf"); // will look in the :/embeddedDocuments resource path

Das Dateinamenpräfix muss mindestens 2 Zeichen lang sein, um Konflikte mit Windows-Laufwerksbuchstaben zu vermeiden.

Suchpfade können Pfade zum Qt-Ressourcensystem enthalten.

Siehe auch searchPaths().

void QDir::setSorting(QDir::SortFlags sort)

Legt die Sortierreihenfolge fest, die von den Funktionen ` entryList()` und ` entryInfoList()` verwendet wird.

Die Sortierreihenfolge ` sort ` wird durch ein OR-Verknüpfung der Werte aus der Enumeration ` QDir::SortFlag` festgelegt.

Siehe auch sorting() und SortFlag.

QDir::SortFlags QDir::sorting() const

Gibt den durch setSorting() festgelegten Wert zurück

Siehe auch setSorting() und SortFlag.

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

Ersetzt diese Instanz von QDir durch other. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

[static] QDir QDir::temp()

Gibt das temporäre Verzeichnis des Systems zurück.

Das Verzeichnis wird unter Verwendung des absoluten kanonischen Pfads des temporären Verzeichnisses gebildet, wodurch sichergestellt wird, dass dessen ` path()` mit dessen ` absolutePath()` übereinstimmt.

Weitere Informationen finden Sie unter ` tempPath()`.

Siehe auch drives(), current(), home() und root().

[static] QString QDir::tempPath()

Gibt den absoluten kanonischen Pfad des temporären Verzeichnisses des Systems zurück.

Auf Unix-/Linux-Systemen ist dies der Pfad in der Umgebungsvariablen „ TMPDIR “ oder „ /tmp “, falls „ TMPDIR “ nicht definiert ist. Unter Windows ist dies in der Regel der Pfad in der Umgebungsvariablen „ TEMP “ oder „ TMP “. Der von dieser Methode zurückgegebene Pfad endet nicht mit einem Verzeichnistrennzeichen, es sei denn, es handelt sich um das Stammverzeichnis (eines Laufwerks).

Siehe auch temp(), currentPath(), homePath() und rootPath().

[static] QString QDir::toNativeSeparators(const QString &pathName)

Gibt „ pathName “ zurück, wobei die Trennzeichen „/“ in Trennzeichen umgewandelt werden, die für das jeweilige Betriebssystem geeignet sind.

Unter Windows gibt toNativeSeparators("c:/winnt/system32") „c:\winnt\system32 “ zurück.

Die zurückgegebene Zeichenfolge kann auf einigen Betriebssystemen, beispielsweise unter Unix, mit dem Argument übereinstimmen.

Siehe auch fromNativeSeparators() und separator().

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

Weist „ other “ dieser „ QDir “-Instanz zu.

QDir &QDir::operator=(const QDir &dir)

Erstellt eine Kopie des Objekts „ dir “ und weist sie diesem Objekt „ QDir “ zu.

QString QDir::operator[](qsizetype pos) const

Gibt den Dateinamen an der Position „ pos “ in der Liste der Dateinamen zurück. Entspricht „ entryList()“.at(index). „ pos “ muss eine gültige Indexposition in der Liste sein (d. h., 0 <= pos < count()).

Siehe auch „ count()“ und „ entryList()“.