QDir Class

Documentation des fonctions membres

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

Crée un objet QDir pointant vers le répertoire indiqué path. Si path est vide, c'est le répertoire de travail du programme (« . ») qui est utilisé.

Voir aussi currentPath().

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

Crée un objet QDir pointant vers le répertoire spécifié path. Si path est vide, c'est le répertoire de travail du programme (« . ») qui est utilisé.

Cette fonction a été introduite dans Qt 6.0.

Voir également currentPath().

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

Crée un QDir avec le chemin path, qui filtre ses entrées par nom à l'aide de nameFilter et par attributs à l'aide de filters. Il trie également les noms à l'aide de sort.

Par défaut, nameFilter est une chaîne vide, ce qui n'exclut rien ; par défaut, filters est AllEntries, ce qui n'exclut rien non plus. Par défaut, sort est Name | IgnoreCase, c'est-à-dire un tri par nom sans distinction de casse.

Si path est une chaîne vide, QDir utilise « . » (le répertoire courant). Si nameFilter est une chaîne vide, QDir utilise le filtre de nom « * » (tous les fichiers).

Voir également exists(), setPath(), setNameFilters(), setFilter() et setSorting().

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

Crée un QDir avec le chemin path, qui filtre ses éléments par nom à l'aide de nameFilter et par attributs à l'aide de filters. Il trie également les noms à l'aide de sort.

Par défaut, nameFilter est une chaîne vide, ce qui n'exclut rien ; par défaut, filters est AllEntries, ce qui n'exclut rien non plus. Par défaut, sort est Name | IgnoreCase, c'est-à-dire un tri par nom sans distinction de casse.

Si path est vide, QDir utilise « . » (le répertoire courant). Si nameFilter est une chaîne vide, QDir utilise le filtre de nom « * » (tous les fichiers).

Cette fonction a été introduite dans Qt 6.0.

Voir également exists(), setPath(), setNameFilters(), setFilter() et setSorting().

QDir::QDir(const QDir &dir)

Crée un objet QDir qui est une copie de l'objet QDir correspondant au répertoire dir.

Voir aussi operator=().

[noexcept] QDir::~QDir()

Supprime l'objet « QDir » et libère ses ressources. Cela n'a aucun effet sur le répertoire sous-jacent du système de fichiers.

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

Renvoie le chemin d'accès absolu d'un fichier situé dans le répertoire. Ne vérifie pas si le fichier existe réellement dans le répertoire ; voir toutefois exists(). Les séparateurs multiples redondants ou les répertoires « . » et « .. » présents dans fileName ne sont pas supprimés (voir cleanPath()).

Voir également relativeFilePath(), filePath() et canonicalPath().

QString QDir::absolutePath() const

Renvoie le chemin absolu (un chemin commençant par « / » ou par la spécification d'un lecteur), qui peut contenir des liens symboliques, mais ne contient jamais de caractères « . », « .. » redondants ni de séparateurs multiples.

Voir également setPath(), canonicalPath(), exists(), cleanPath(), dirName() et absoluteFilePath().

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

Ajoute path au chemin de recherche pour prefix.

Voir également setSearchPaths().

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

Cette fonction a été introduite dans Qt 6.0.

QString QDir::canonicalPath() const

Renvoie le chemin canonique, c'est-à-dire un chemin sans liens symboliques ni éléments redondants « . » ou « .. ».

Sur les systèmes ne disposant pas de liens symboliques, cette fonction renvoie toujours la même chaîne que celle renvoyée par absolutePath(). Cette méthode renvoie une chaîne vide si l'entrée n'existe pas, n'est pas accessible (par exemple, si l'utilisateur actuel n'a pas accès à un chemin de répertoire) ou si une erreur se produit lors de la canonicalisation du chemin (généralement en raison de liens symboliques orphelins).

Exemple :

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

Voir également path(), absolutePath(), exists(), cleanPath(), dirName() et absoluteFilePath().

bool QDir::cd(const QString &dirName)

Modifie le répertoire de l'QDir pour le remplacer par dirName.

Renvoie true si le nouveau répertoire existe ; sinon, renvoie false. Notez que l'opération logique cd() n'est pas effectuée si le nouveau répertoire n'existe pas.

L'appel de cd("..") équivaut à l'appel de cdUp().

Voir également cdUp(), isReadable(), exists() et path().

bool QDir::cdUp()

Permet de changer de répertoire en remontant d'un niveau par rapport au répertoire courant de l'QDir.

Renvoie ` true ` si le nouveau répertoire existe ; sinon, renvoie ` false`. Notez que l'opération logique `cdUp()` n'est pas effectuée si le nouveau répertoire n'existe pas.

Voir également cd(), isReadable(), exists() et path().

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

Renvoie path avec les séparateurs de répertoires normalisés (c'est-à-dire les séparateurs natifs de la plateforme convertis en « / ») et les séparateurs redondants supprimés, et les « . » et « .. » résolus (dans la mesure du possible).

Les liens symboliques sont conservés. Cette fonction ne renvoie pas le chemin canonique, mais plutôt la version la plus simple de l'entrée. Par exemple, « ./local » devient « local », « local/../bin » devient « bin » et « /local/usr/../bin » devient « /local/bin ».

Voir également absolutePath() et canonicalPath().

qsizetype QDir::count() const

Renvoie le nombre total de répertoires et de fichiers présents dans le répertoire.

Équivalent à ` entryList()`.count().

Voir aussi operator[]() et entryList().

[static] QDir QDir::current()

Renvoie le répertoire actuel de l'application.

Le répertoire est construit à partir du chemin absolu du répertoire actuel, ce qui garantit que sa méthode ` path()` renverra la même valeur que sa méthode ` absolutePath()`.

Voir également currentPath(), setCurrent(), home(), root() et temp().

[static] QString QDir::currentPath()

Renvoie le chemin absolu du répertoire courant de l'application. Le répertoire courant correspond au dernier répertoire défini à l'aide de la fonction QDir::setCurrent() ou, si celle-ci n'a jamais été appelée, au répertoire à partir duquel cette application a été lancée par le processus parent.

Voir également current(), setCurrent(), homePath(), rootPath(), tempPath() et QCoreApplication::applicationDirPath().

QString QDir::dirName() const

Renvoie le nom du répertoire ; celui-ci n' est pas identique au chemin d'accès. Par exemple, un répertoire nommé « mail » peut avoir pour chemin d'accès « /var/spool/mail ». Si le répertoire n'a pas de nom (par exemple, s'il s'agit du répertoire racine), une chaîne vide est renvoyée.

Aucune vérification n'est effectuée pour s'assurer qu'un répertoire portant ce nom existe réellement ; voir toutefois exists().

Voir également path(), filePath(), absolutePath() et absoluteFilePath().

[static] QFileInfoList QDir::drives()

Renvoie une liste des répertoires racines de ce système.

Sous Windows, cette fonction renvoie une liste d'objets de type ` QFileInfo ` contenant « C:/ », « D:/ », etc. Elle ne renvoie pas les lecteurs contenant des supports amovibles vides. Sur les autres systèmes d'exploitation, elle renvoie une liste ne contenant qu'un seul répertoire racine (c'est-à-dire « / »).

Voir également root() et rootPath().

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

Renvoie une liste d’objets ` QFileInfo ` correspondant à tous les fichiers et répertoires du répertoire, classés selon les filtres de nom et d’attributs précédemment définis avec ` setNameFilters()` et ` setFilter()`, et triés selon les indicateurs définis avec ` setSorting()`.

Le filtre de nom, le filtre d’attributs de fichier et la spécification de tri peuvent être remplacés à l’aide des arguments nameFilters, filters et sort.

Renvoie une liste vide si le répertoire est illisible, n’existe pas ou si aucune entrée ne correspond aux spécifications.

Pour les répertoires volumineux, cette fonction peut entraîner un pic de mémoire car elle crée une instance de ` QFileInfo ` pour chaque entrée du répertoire. Envisagez d'utiliser ` QDirListing ` si l'objectif est de parcourir les éléments un par un.

Voir également entryList(), setNameFilters(), setSorting(), setFilter(), isReadable() et exists().

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

Renvoie une liste d'objets ` QFileInfo ` correspondant à tous les fichiers et répertoires du répertoire, classés selon les filtres de nom et d'attribut précédemment définis avec ` setNameFilters()` et ` setFilter()`, et triés selon les indicateurs définis avec ` setSorting()`.

Les spécifications de filtrage par attribut et de tri peuvent être remplacées à l’aide des arguments filters et sort.

Renvoie une liste vide si le répertoire est illisible, n'existe pas ou si aucune entrée ne correspond aux spécifications.

Pour les répertoires volumineux, cette fonction peut entraîner un pic de mémoire car elle crée une instance de ` QFileInfo ` pour chaque entrée du répertoire. Envisagez d’utiliser ` QDirListing ` si l’objectif est de parcourir les éléments un par un.

Voir également entryList(), setNameFilters(), setSorting(), setFilter(), isReadable() et exists().

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

Renvoie une liste des noms de tous les fichiers et répertoires présents dans le répertoire, classés selon les filtres de nom et d’attribut précédemment définis à l’aide des fonctions ` setNameFilters()` et ` setFilter()`, et triés selon les indicateurs définis à l’aide de la fonction ` setSorting()`.

Le filtre de nom, le filtre d’attribut de fichier et la spécification de tri peuvent être remplacés à l’aide des arguments nameFilters, filters et sort.

Renvoie une liste vide si le répertoire est illisible, s’il n’existe pas ou si aucune entrée ne correspond aux spécifications.

Pour les répertoires volumineux, cette fonction peut entraîner un pic de mémoire car elle crée une instance de ` QString ` pour chaque entrée du répertoire. Envisagez d’utiliser ` QDirListing ` si l’objectif est de parcourir les éléments un par un.

Voir également entryInfoList(), setNameFilters(), setSorting() et setFilter().

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

Renvoie une liste des noms de tous les fichiers et répertoires présents dans le répertoire, classés selon les filtres de nom et d'attribut précédemment définis à l'aide des fonctions ` setNameFilters()` et ` setFilter()`, et triés selon les indicateurs définis à l'aide de la fonction ` setSorting()`.

Le filtre d’attributs et les spécifications de tri peuvent être remplacés à l’aide des arguments filters et sort.

Renvoie une liste vide si le répertoire est illisible, n'existe pas ou si aucun élément ne correspond aux spécifications.

Pour les répertoires volumineux, cette fonction peut entraîner un pic de mémoire car elle crée une instance de ` QString ` pour chaque entrée du répertoire. Envisagez d’utiliser ` QDirListing ` si l’objectif est de parcourir les éléments un par un.

Voir également entryInfoList(), setNameFilters(), setSorting() et setFilter().

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

Renvoie ` true ` si le fichier nommé ` name ` existe ; sinon, renvoie `false`.

À moins que name ne contienne un chemin d'accès absolu, le nom du fichier est considéré comme relatif au répertoire lui-même ; cette fonction est donc généralement utilisée pour vérifier la présence de fichiers dans un répertoire.

Voir également QFileInfo::exists() et QFile::exists().

bool QDir::exists() const

Renvoie ` true ` si le répertoire existe ; sinon, renvoie ` false`. (Si un fichier portant le même nom est détecté, cette fonction renvoie `false`).

La surcharge de cette fonction qui accepte un argument sert à vérifier la présence de fichiers et de répertoires dans un répertoire.

Voir également QFileInfo::exists() et QFile::exists().

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

Renvoie le chemin d'accès d'un fichier dans le répertoire. Ne vérifie pas si le fichier existe réellement dans le répertoire ; voir toutefois exists(). Si l'QDir est relative, le chemin d'accès renvoyé sera également relatif. Les séparateurs multiples redondants ou les répertoires « . » et « .. » dans fileName ne sont pas supprimés (voir cleanPath()).

Voir également dirName(), absoluteFilePath(), isRelative() et canonicalPath().

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

Renvoie absolutePath() sous la forme std::filesystem::path.

Cette fonction a été introduite dans Qt 6.0.

Voir également absolutePath().

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

Renvoie canonicalPath() sous la forme std::filesystem::path.

Cette fonction a été introduite dans Qt 6.0.

Voir également canonicalPath().

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

Renvoie path() sous la forme std::filesystem::path.

Cette fonction a été introduite dans Qt 6.0.

Voir également path().

QDir::Filters QDir::filter() const

Renvoie la valeur définie par la fonction setFilter()

Voir aussi setFilter().

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

Renvoie l'pathName ion en utilisant « / » comme séparateur de répertoires. Sous Windows, par exemple, fromNativeSeparators("c:\\winnt\\system32") renvoie « c:/winnt/system32 ».

La chaîne renvoyée peut être identique à l'argument sur certains systèmes d'exploitation, par exemple sous Unix.

Voir également toNativeSeparators() et separator().

[static] QDir QDir::home()

Renvoie le répertoire personnel de l'utilisateur.

Le répertoire est construit à partir du chemin absolu du répertoire personnel, ce qui garantit que sa fonction path() sera identique à celle de absolutePath().

Voir homePath() pour plus de détails.

Voir également les fonctions drives(), current(), root() et temp().

[static] QString QDir::homePath()

Renvoie le chemin absolu du répertoire personnel de l'utilisateur.

Sous Windows, cette fonction renvoie le répertoire du profil de l'utilisateur actuel. En général, il s'agit de :

C:/Users/Username

Utilisez la fonction ` toNativeSeparators()` pour convertir les séparateurs en ceux adaptés au système d'exploitation sous-jacent.

Si le répertoire du profil de l'utilisateur actuel n'existe pas ou ne peut être récupéré, les alternatives suivantes seront vérifiées (dans l'ordre indiqué) jusqu'à ce qu'un chemin existant et disponible soit trouvé :

1. Le chemin spécifié par la variable d'environnement ` USERPROFILE `.
2. Le chemin formé en concaténant les variables d’environnement ` HOMEDRIVE ` et ` HOMEPATH `.
3. Le chemin spécifié par la variable d'environnement ` HOME `.
4. Le chemin renvoyé par la fonction rootPath() (qui utilise la variable d'environnement SystemDrive )
5. Le répertoire C:/.

Sous les systèmes d'exploitation autres que Windows, la variable d'environnement HOME est utilisée si elle existe ; sinon, c'est le chemin renvoyé par la fonction rootPath().

Voir également home(), currentPath(), rootPath() et tempPath().

bool QDir::isAbsolute() const

Renvoie « true » si le chemin d'accès au répertoire est absolu ; sinon, renvoie « false ». Voir isAbsolutePath().

Voir également isRelative(), makeAbsolute() et cleanPath().

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

Renvoie « true » si « path » est un chemin absolu ; renvoie « false » s'il s'agit d'un chemin relatif.

Voir également isAbsolute(), isRelativePath(), makeAbsolute(), cleanPath() et QResource.

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

Indique si le répertoire est vide.

Équivalent à ` count() == 0 ` avec les filtres ` QDir::AllEntries | QDir::NoDotAndDotDot`, mais plus rapide car il vérifie simplement si le répertoire contient au moins une entrée.

Voir également count(), entryList() et setFilter().

bool QDir::isReadable() const

Renvoie « true » si le répertoire est accessible en lecture et qu’il est possible d’ouvrir les fichiers par leur nom ; sinon, renvoie « false ».

Voir aussi QFileInfo::isReadable().

bool QDir::isRelative() const

Renvoie « true » si le chemin d'accès au répertoire est relatif ; sinon, renvoie « false ». (Sous Unix, un chemin est relatif s'il ne commence pas par un « / »).

Voir également makeAbsolute(), isAbsolute(), isAbsolutePath() et cleanPath().

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

Renvoie « true » si « path » est un chemin relatif ; renvoie « false » s'il s'agit d'un chemin absolu.

Voir également isRelative(), isAbsolutePath() et makeAbsolute().

bool QDir::isRoot() const

Renvoie « true » si le répertoire est le répertoire racine ; sinon, renvoie « false ».

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

Voir également root() et rootPath().

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

Renvoie le séparateur natif des chemins d'accès : « : » sous Unix et « ; » sous Windows.

Voir aussi separator().

bool QDir::makeAbsolute()

Convertit le chemin d'accès au répertoire en chemin absolu. Si celui-ci est déjà absolu, aucune action n'est effectuée. Renvoie « true » si la conversion a réussi ; sinon, renvoie « false ».

Voir également isAbsolute(), isAbsolutePath(), isRelative() et cleanPath().

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

Renvoie « true » si l’ fileName correspond au motif générique (glob) « filter » ; sinon, renvoie « false ». L’ filter peut contenir plusieurs motifs séparés par des espaces ou des points-virgules. La correspondance ne tient pas compte de la casse.

Voir également QRegularExpression::fromWildcard(), entryList() et entryInfoList().

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

Renvoie « true » si l'fileName correspond à l'un des motifs génériques (glob) de la liste « filters » ; sinon, renvoie « false ». La correspondance ne tient pas compte de la casse.

Voir également QRegularExpression::fromWildcard(), entryList() et entryInfoList().

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

Crée un sous-répertoire nommé « dirName » avec le contenu spécifié dans « permissions ».

Si permissions correspond à std::nullopt (valeur par défaut), cette fonction définit les droits d'accès par défaut.

Renvoie true en cas de succès ; renvoie false si l'opération a échoué ou si dirName existait déjà.

Si dirName existait déjà, cette méthode ne modifie pas ses permissions.

Sur les systèmes POSIX, les fichiers permissions sont modifiés par le umask (masque de création de fichier) du processus en cours, ce qui signifie que certains bits de permission peuvent être désactivés.

Sous Windows, par défaut, un nouveau répertoire hérite des autorisations de son répertoire parent. Les fichiers « permissions » sont émulés à l’aide d’ACL. Ces ACL peuvent ne pas respecter l’ordre canonique lorsque le groupe se voit accorder moins d’autorisations que les autres. Les fichiers et répertoires dotés de telles autorisations génèrent des avertissements lorsque l’onglet « Sécurité » de la boîte de dialogue « Propriétés » est ouvert. L’octroi au groupe de toutes les autorisations accordées aux autres permet d’éviter ces avertissements.

Voir également ` rmdir()`, ` mkpath()` et ` rmpath()`.

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

Crée un répertoire nommé « dirPath ».

Si dirPath n'existe pas encore, cette méthode le créera – ainsi que tous les répertoires parents inexistants – avec les droits d'accès suivants : permissions.

Si dirPath existait déjà, cette méthode ne modifiera pas ses droits d’accès ; il en va de même pour tous les répertoires parents déjà existants.

Si permissions est std::nullopt (valeur par défaut), cette fonction définira les droits par défaut.

Renvoie true en cas de succès ou si dirPath existait déjà ; sinon, renvoie false.

Sur les systèmes POSIX, les fichiers permissions sont modifiés par le umask (masque de création de fichier) du processus en cours, ce qui signifie que certains bits de permission peuvent être désactivés.

Sous Windows, par défaut, un nouveau répertoire hérite des autorisations de son répertoire parent. Les permissions sont émulées à l’aide d’ACL. Ces ACL peuvent ne pas respecter l’ordre canonique lorsque le groupe se voit accorder moins d’autorisations que les autres. Les fichiers et répertoires dotés de telles autorisations génèrent des avertissements lorsque l’onglet « Sécurité » de la boîte de dialogue « Propriétés » est ouvert. Accorder au groupe toutes les autorisations accordées aux autres permet d’éviter ces avertissements.

Voir également rmpath(), mkdir() et rmdir().

QStringList QDir::nameFilters() const

Renvoie la liste de chaînes définie par la fonction setNameFilters()

Voir également setNameFilters().

QString QDir::path() const

Renvoie le chemin d'accès. Celui-ci peut contenir des liens symboliques, mais ne contient jamais de « . », « .. » redondants ni de séparateurs multiples.

Le chemin renvoyé peut être absolu ou relatif (voir setPath()).

Voir également setPath(), absolutePath(), exists(), cleanPath(), dirName(), absoluteFilePath(), toNativeSeparators() et makeAbsolute().

void QDir::refresh() const

Actualise les informations du répertoire.

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

Renvoie le chemin d'accès à fileName par rapport au répertoire.

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"

Voir également absoluteFilePath(), filePath() et canonicalPath().

bool QDir::remove(const QString &fileName)

Supprime le fichier « fileName ».

Renvoie true si le fichier a été supprimé avec succès ; sinon, renvoie false.

bool QDir::removeRecursively()

Supprime le répertoire, y compris tout son contenu.

Renvoie « true » en cas de succès, sinon « false ».

Si un fichier ou un répertoire ne peut pas être supprimé, la méthode removeRecursively() continue et tente de supprimer autant de fichiers et de sous-répertoires que possible, puis renvoie « false ».

Si le répertoire a déjà été supprimé, la méthode renvoie « true » (résultat attendu déjà atteint).

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

Renomme un fichier ou un répertoire de oldName en newName et renvoie `true` en cas de succès ; sinon, renvoie ` false`.

Sur la plupart des systèmes de fichiers, la fonction `rename()` échoue uniquement si ` oldName ` n’existe pas ou si un fichier portant le nouveau nom existe déjà. Cependant, il existe d’autres raisons pour lesquelles `rename()` peut échouer. Par exemple, sur au moins un système de fichiers, `rename()` échoue si ` newName ` pointe vers un fichier ouvert.

Si oldName est un fichier (et non un répertoire) qui ne peut pas être renommé immédiatement, Qt tentera de copier oldName vers newName et de supprimer oldName.

Voir également QFile::rename().

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

Supprime le répertoire indiqué par ` dirName`.

Le répertoire doit être vide pour que la fonction rmdir() aboutisse.

Renvoie true en cas de succès ; sinon, renvoie false.

Voir également mkdir().

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

Supprime le chemin d'accès au répertoire dirPath.

La fonction supprime tous les répertoires parents de dirPath, à condition qu'ils soient vides. C'est l'inverse de la fonction mkpath(dirPath).

Renvoie true en cas de succès ; sinon, renvoie false.

Voir également mkpath().

[static] QDir QDir::root()

Renvoie le répertoire racine.

Le répertoire est construit à partir du chemin absolu du répertoire racine, ce qui garantit que sa fonction ` path()` sera identique à sa fonction ` absolutePath()`.

Voir rootPath() pour plus de détails.

Voir également les fonctions drives(), current(), home() et temp().

[static] QString QDir::rootPath()

Renvoie le chemin absolu du répertoire racine.

Sous les systèmes d'exploitation Unix, cette fonction renvoie « / ». Sous les systèmes de fichiers Windows, elle renvoie généralement « c:/ ».

Voir également root(), drives(), currentPath(), homePath() et tempPath().

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

Renvoie les chemins de recherche pour prefix.

Voir également setSearchPaths() et addSearchPath().

[static] QChar QDir::separator()

Renvoie le séparateur de répertoire natif : « / » sous Unix et « \ » sous Windows.

Vous n'avez pas besoin d'utiliser cette fonction pour construire des chemins d'accès aux fichiers. Si vous utilisez toujours « / », Qt convertira vos chemins d'accès pour qu'ils soient conformes au système d'exploitation sous-jacent. Si vous souhaitez afficher les chemins d'accès à l'utilisateur en utilisant le séparateur de son système d'exploitation, utilisez toNativeSeparators().

Voir également listSeparator().

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

Définit le répertoire de travail actuel de l'application sur path. Renvoie true si le changement de répertoire a réussi ; sinon, renvoie false.

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"

Voir également current(), currentPath(), home(), root() et temp().

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

Définit le filtre utilisé par les fonctions entryList() et entryInfoList() sur filters. Ce filtre permet de spécifier le type de fichiers qui doivent être renvoyés par les fonctions entryList() et entryInfoList(). Voir QDir::Filter.

Voir également filter() et setNameFilters().

void QDir::setNameFilters(const QStringList &nameFilters)

Définit les filtres de nom utilisés par entryList() et entryInfoList() sur la liste de filtres spécifiée par nameFilters.

Chaque filtre de nom est un filtre à caractères génériques (globbing) qui prend en charge les caractères génériques des fonctions * et ?. Voir QRegularExpression::fromWildcard().

Par exemple, le code suivant définit trois filtres de nom sur une liste de fichiers ( QDir ) afin de garantir que seuls les fichiers dont l’extension est couramment utilisée pour les fichiers source C++ soient répertoriés :

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

Voir également nameFilters() et setFilter().

void QDir::setPath(const QString &path)

Définit le chemin d'accès au répertoire path. Le chemin est débarrassé des caractères redondants « . », « .. » et des séparateurs multiples. Aucune vérification n'est effectuée pour s'assurer qu'un répertoire correspondant à ce chemin existe réellement ; vous pouvez toutefois le vérifier vous-même à l'aide de la fonction exists().

Le chemin peut être absolu ou relatif. Les chemins absolus commencent par le séparateur de répertoire « / » (éventuellement précédé d'une spécification de lecteur sous Windows). Les noms de fichiers relatifs commencent par un nom de répertoire ou un nom de fichier et spécifient un chemin relatif au répertoire courant. Un exemple de chemin absolu est la chaîne « /tmp/quartz », tandis qu’un chemin relatif pourrait ressembler à « src/fatlib ».

Voir également path(), absolutePath(), exists(), cleanPath(), dirName(), absoluteFilePath(), isRelative() et makeAbsolute().

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

Cette fonction a été introduite dans Qt 6.0.

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

Définit ou remplace les chemins de recherche de Qt pour les noms de fichiers comportant le préfixe « prefix » par « searchPaths ».

Pour spécifier un préfixe pour un nom de fichier, faites précéder le préfixe d’un seul deux-points (par exemple, « images:undo.png », « xmldocs:books.xml »). prefix ne peut contenir que des lettres ou des chiffres (par exemple, il ne peut contenir ni deux-points, ni barre oblique).

Qt utilise ce chemin de recherche pour localiser les fichiers comportant un préfixe connu. Les entrées du chemin de recherche sont vérifiées dans l'ordre, en commençant par la première.

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

Le préfixe du nom de fichier doit comporter au moins 2 caractères afin d’éviter tout conflit avec les lettres de lecteur Windows.

Les chemins de recherche peuvent contenir des chemins vers le système de ressources Qt.

Voir également searchPaths().

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

Définit l'ordre de tri utilisé par les fonctions entryList() et entryInfoList().

L'sort est spécifiée en combinant par opération OU les valeurs de l'énumération QDir::SortFlag.

Voir également sorting() et SortFlag.

QDir::SortFlags QDir::sorting() const

Renvoie la valeur définie par la fonction setSorting()

Voir également setSorting() et SortFlag.

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

Remplace cette instance de QDir par other. Cette opération est très rapide et ne rencontre jamais d'échec.

[static] QDir QDir::temp()

Renvoie le répertoire temporaire du système.

Ce répertoire est construit à partir du chemin canonique absolu du répertoire temporaire, ce qui garantit que sa fonction ` path()` donnera le même résultat que sa fonction ` absolutePath()`.

Voir tempPath() pour plus de détails.

Voir également les fonctions drives(), current(), home() et root().

[static] QString QDir::tempPath()

Renvoie le chemin canonique absolu du répertoire temporaire du système.

Sur les systèmes Unix/Linux, il s'agit du chemin indiqué dans la variable d'environnement ` TMPDIR ` ou ` /tmp ` si ` TMPDIR ` n'est pas défini. Sous Windows, il s'agit généralement du chemin indiqué dans la variable d'environnement ` TEMP ` ou ` TMP `. Le chemin renvoyé par cette méthode ne se termine pas par un séparateur de répertoire, sauf s'il s'agit du répertoire racine (d'un lecteur).

Voir également temp(), currentPath(), homePath() et rootPath().

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

Renvoie pathName, les séparateurs « / » ayant été convertis en séparateurs adaptés au système d'exploitation sous-jacent.

Sous Windows, toNativeSeparators("c:/winnt/system32") renvoie "c:\winnt\system32 ".

La chaîne renvoyée peut être identique à l'argument sur certains systèmes d'exploitation, par exemple sous Unix.

Voir également fromNativeSeparators() et separator().

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

Cette opération attribue l'other à cette instance QDir.

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

Crée une copie de l'objet « dir » et l'attribue à cet objet « QDir ».

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

Renvoie le nom de fichier situé à la position pos dans la liste des noms de fichiers. Équivalent à entryList().at(index). pos doit être une position d'index valide dans la liste (c'est-à-dire 0 <= pos < count()).

Voir également count() et entryList().