QDir Class

Documentación de las funciones miembro

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

Construye un QDir apuntando al directorio dado path. Si path está vacío se utiliza el directorio de trabajo del programa, (".").

Véase también currentPath().

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

Construye un QDir apuntando al directorio dado path. Si path está vacío se utiliza el directorio de trabajo del programa, (".").

Esta función se introdujo en Qt 6.0.

Véase también currentPath().

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

Construye un QDir con la ruta path, que filtra sus entradas por nombre usando nameFilter y por atributos usando filters. También ordena los nombres usando sort.

Por defecto nameFilter es una cadena vacía, que no excluye nada; por defecto filters es AllEntries, que tampoco excluye nada. El valor por defecto sort es Name | IgnoreCase, es decir, ordena por nombre insensible a mayúsculas y minúsculas.

Si path es una cadena vacía, QDir utiliza "." (el directorio actual). Si nameFilter es una cadena vacía, QDir utiliza el filtro de nombres "*" (todos los archivos).

Véase también exists(), setPath(), setNameFilters(), setFilter() y setSorting().

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

Construye un QDir con la ruta path, que filtra sus entradas por nombre usando nameFilter y por atributos usando filters. También ordena los nombres usando sort.

Por defecto nameFilter es una cadena vacía, que no excluye nada; por defecto filters es AllEntries, que tampoco excluye nada. El valor por defecto sort es Name | IgnoreCase, es decir, ordena por nombre insensible a mayúsculas y minúsculas.

Si path está vacío, QDir utiliza "." (el directorio actual). Si nameFilter es una cadena vacía, QDir utiliza el filtro de nombres "*" (todos los archivos).

Esta función se introdujo en Qt 6.0.

Véase también exists(), setPath(), setNameFilters(), setFilter(), y setSorting().

QDir::QDir(const QDir &dir)

Construye un objeto QDir que es una copia del objeto QDir para el directorio dir.

Véase también operator=().

[noexcept] QDir::~QDir()

Destruye el objeto QDir y libera sus recursos. Esto no tiene ningún efecto sobre el directorio subyacente en el sistema de archivos.

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

Devuelve el nombre de la ruta absoluta de un archivo en el directorio. No comprueba si el fichero existe realmente en el directorio; pero véase exists(). Los separadores múltiples redundantes o los directorios "." y ".." en fileName no se eliminan (véase cleanPath()).

Véase también relativeFilePath(), filePath() y canonicalPath().

QString QDir::absolutePath() const

Devuelve la ruta absoluta (una ruta que comienza con "/" o con una especificación de unidad), que puede contener enlaces simbólicos, pero nunca contiene ".", ".." redundantes ni separadores múltiples.

Véase también setPath(), canonicalPath(), exists(), cleanPath(), dirName() y absoluteFilePath().

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

Añade path a la ruta de búsqueda de prefix.

Véase también setSearchPaths().

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

Esta función se introdujo en Qt 6.0.

QString QDir::canonicalPath() const

Devuelve la ruta canónica, es decir, una ruta sin enlaces simbólicos ni elementos "." o ".." redundantes.

En sistemas que no tienen enlaces simbólicos, esta función siempre devolverá la misma cadena que absolutePath(). Si la ruta canónica no existe (normalmente debido a enlaces simbólicos colgantes) canonicalPath() devuelve una cadena vacía.

Ejemplo:

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

Véase también path(), absolutePath(), exists(), cleanPath(), dirName(), y absoluteFilePath().

bool QDir::cd(const QString &dirName)

Cambia el directorio QDir's a dirName.

Devuelve true si el nuevo directorio existe; en caso contrario devuelve false. Tenga en cuenta que la operación lógica cd() no se realiza si el nuevo directorio no existe.

Llamar a cd("..") es equivalente a llamar a cdUp().

Véase también cdUp(), isReadable(), exists() y path().

bool QDir::cdUp()

Cambia de directorio desplazándose un directorio hacia arriba desde el directorio actual de QDir.

Devuelve true si el nuevo directorio existe; en caso contrario devuelve false. Tenga en cuenta que la operación lógica cdUp() no se realiza si el nuevo directorio no existe.

Véase también cd(), isReadable(), exists() y path().

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

Devuelve path con los separadores de directorio normalizados (es decir, los separadores nativos de la plataforma convertidos a "/") y los redundantes eliminados, y los ". "s y ".. "s resueltos (en la medida de lo posible).

Se mantienen los enlaces simbólicos. Esta función no devuelve la ruta canónica, sino la versión más simple de la entrada. Por ejemplo, "./local" se convierte en "local", "local/../bin" en "bin" y "/local/usr/../bin" en "/local/bin".

Véase también absolutePath() y canonicalPath().

qsizetype QDir::count() const

Devuelve el número total de directorios y archivos del directorio.

Equivale a entryList().count().

Véase también operator[]() y entryList().

[static] QDir QDir::current()

Devuelve el directorio actual de la aplicación.

El directorio se construye utilizando la ruta absoluta del directorio actual, asegurando que su path() será el mismo que su absolutePath().

Véase también currentPath(), setCurrent(), home(), root() y temp().

[static] QString QDir::currentPath()

Devuelve la ruta absoluta del directorio actual de la aplicación. El directorio actual es el último directorio establecido con QDir::setCurrent() o, si nunca se llamó, el directorio en el que esta aplicación fue iniciada por el proceso padre.

Ver también current(), setCurrent(), homePath(), rootPath(), tempPath(), y QCoreApplication::applicationDirPath().

QString QDir::dirName() const

Devuelve el nombre del directorio; no es lo mismo que la ruta, por ejemplo, un directorio con el nombre "mail", podría tener la ruta "/var/spool/mail". Si el directorio no tiene nombre (por ejemplo, es el directorio raíz) se devuelve una cadena vacía.

No se comprueba que exista realmente un directorio con este nombre; pero véase exists().

Véase también path(), filePath(), absolutePath() y absoluteFilePath().

[static] QFileInfoList QDir::drives()

Devuelve una lista de los directorios raíz de este sistema.

En Windows, devuelve una lista de objetos QFileInfo que contienen "C:/", "D:/", etc. No devuelve unidades con soportes extraíbles que estén vacías. En otros sistemas operativos, devuelve una lista que contiene sólo un directorio raíz (es decir, "/").

Véase también root() y rootPath().

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

Devuelve una lista de objetos QFileInfo para todos los archivos y directorios del directorio, ordenados según los filtros de nombres y atributos establecidos previamente con setNameFilters() y setFilter(), y ordenados según las banderas establecidas con setSorting().

El filtro de nombres, el filtro de atributos de archivos y la especificación de ordenación pueden modificarse con los argumentos nameFilters, filters y sort.

Devuelve una lista vacía si el directorio es ilegible, no existe o si nada coincide con la especificación.

Véase también entryList(), setNameFilters(), setSorting(), setFilter(), isReadable() y exists().

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

Devuelve una lista de objetos QFileInfo para todos los archivos y directorios del directorio, ordenados según los filtros de nombres y atributos establecidos previamente con setNameFilters() y setFilter(), y ordenados según las banderas establecidas con setSorting().

El filtro de atributos y las especificaciones de ordenación se pueden anular utilizando los argumentos filters y sort.

Devuelve una lista vacía si el directorio es ilegible, no existe, o si nada coincide con la especificación.

Véase también entryList(), setNameFilters(), setSorting(), setFilter(), isReadable() y exists().

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

Devuelve una lista de los nombres de todos los archivos y directorios del directorio, ordenados según los filtros de nombres y atributos establecidos previamente con setNameFilters() y setFilter(), y ordenados según las banderas establecidas con setSorting().

El filtro de nombres, el filtro de atributos de archivos y la especificación de ordenación se pueden anular utilizando los argumentos nameFilters, filters y sort.

Devuelve una lista vacía si el directorio es ilegible, no existe o si nada coincide con la especificación.

Véase también entryInfoList(), setNameFilters(), setSorting() y setFilter().

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

Devuelve una lista de los nombres de todos los archivos y directorios del directorio, ordenados según los filtros de nombres y atributos establecidos previamente con setNameFilters() y setFilter(), y ordenados según las banderas establecidas con setSorting().

El filtro de atributos y las especificaciones de ordenación se pueden anular utilizando los argumentos filters y sort.

Devuelve una lista vacía si el directorio es ilegible, no existe, o si nada coincide con la especificación.

Véase también entryInfoList(), setNameFilters(), setSorting() y setFilter().

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

Devuelve true si el archivo llamado name existe; en caso contrario devuelve false.

A menos que name contenga una ruta de archivo absoluta, se asume que el nombre del archivo es relativo al propio directorio, por lo que esta función se utiliza normalmente para comprobar la presencia de archivos dentro de un directorio.

Véase también QFileInfo::exists() y QFile::exists().

bool QDir::exists() const

Devuelve true si el directorio existe; en caso contrario devuelve false. (Si se encuentra un archivo con el mismo nombre esta función devolverá false).

La sobrecarga de esta función que acepta un argumento se utiliza para comprobar la presencia de ficheros y directorios dentro de un directorio.

Véase también QFileInfo::exists() y QFile::exists().

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

Devuelve el nombre de la ruta de un archivo en el directorio. No comprueba si el fichero existe realmente en el directorio; pero véase exists(). Si QDir es relativo, el nombre de ruta devuelto también lo será. Los separadores múltiples redundantes o los directorios "." y ".." en fileName no se eliminan (véase cleanPath()).

Véase también dirName(), absoluteFilePath(), isRelative() y canonicalPath().

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

Devuelve absolutePath() como std::filesystem::path.

Esta función se introdujo en Qt 6.0.

Véase también absolutePath().

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

Devuelve canonicalPath() como std::filesystem::path.

Esta función se introdujo en Qt 6.0.

Véase también canonicalPath().

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

Devuelve path() como std::filesystem::path.

Esta función se introdujo en Qt 6.0.

Véase también path().

QDir::Filters QDir::filter() const

Devuelve el valor establecido por setFilter()

Véase también setFilter().

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

Devuelve pathName utilizando '/' como separador de archivos. En Windows, por ejemplo, fromNativeSeparators("c:\\winnt\\system32") devuelve "c:/winnt/system32".

La cadena devuelta puede ser la misma que el argumento en algunos sistemas operativos, por ejemplo en Unix.

Véase también toNativeSeparators() y separator().

[static] QDir QDir::home()

Devuelve el directorio personal del usuario.

El directorio se construye utilizando la ruta absoluta del directorio raíz, asegurando que su path() será el mismo que su absolutePath().

Véase homePath() para más detalles.

Véase también drives(), current(), root(), y temp().

[static] QString QDir::homePath()

Devuelve la ruta absoluta del directorio personal del usuario.

En Windows esta función devolverá el directorio del perfil del usuario actual. Típicamente, esto es:

C:/Users/Username

Utilice la función toNativeSeparators() para convertir los separadores a los adecuados para el sistema operativo subyacente.

Si el directorio del perfil del usuario actual no existe o no se puede recuperar, se comprobarán las siguientes alternativas (en el orden indicado) hasta que se encuentre una ruta existente y disponible:

1. La ruta especificada por la variable de entorno USERPROFILE.
2. La ruta formada por la concatenación de las variables de entorno HOMEDRIVE y HOMEPATH.
3. La ruta especificada por la variable de entorno HOME.
4. La ruta devuelta por la función rootPath() (que utiliza la variable de entorno SystemDrive ).
5. El directorio C:/.

En los sistemas operativos distintos de Windows, se utiliza la variable de entorno HOME si existe; en caso contrario, la ruta devuelta por la función rootPath().

Véase también home(), currentPath(), rootPath() y tempPath().

bool QDir::isAbsolute() const

Devuelve true si la ruta del directorio es absoluta; en caso contrario devuelve false. Véase isAbsolutePath().

Véase también isRelative(), makeAbsolute() y cleanPath().

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

Devuelve true si path es absoluta; devuelve false si es relativa.

Véase también isAbsolute(), isRelativePath(), makeAbsolute(), cleanPath() y QResource.

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

Devuelve si el directorio está vacío.

Equivale a count() == 0 con filtros QDir::AllEntries | QDir::NoDotAndDotDot, pero es más rápido ya que sólo comprueba si el directorio contiene al menos una entrada.

Véase también count(), entryList(), y setFilter().

bool QDir::isReadable() const

Devuelve true si el directorio es legible y podemos abrir ficheros por su nombre; en caso contrario devuelve false.

Véase también QFileInfo::isReadable().

bool QDir::isRelative() const

Devuelve true si la ruta del directorio es relativa; en caso contrario, devuelve false. (En Unix, una ruta es relativa si no empieza por "/").

Véase también makeAbsolute(), isAbsolute(), isAbsolutePath() y cleanPath().

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

Devuelve true si path es relativa; devuelve false si es absoluta.

Véase también isRelative(), isAbsolutePath() y makeAbsolute().

bool QDir::isRoot() const

Devuelve true si el directorio es el directorio raíz; en caso contrario devuelve false.

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

Véase también root() y rootPath().

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

Devuelve el separador nativo de la lista de rutas: ':' en Unix y ';' en Windows.

Véase también separator().

bool QDir::makeAbsolute()

Convierte la ruta del directorio en una ruta absoluta. Si ya es absoluta, no ocurre nada. Devuelve true si la conversión ha tenido éxito; en caso contrario devuelve false.

Véase también isAbsolute(), isAbsolutePath(), isRelative() y cleanPath().

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

Devuelve true si fileName coincide con el patrón comodín (glob) filter; en caso contrario devuelve false. filter puede contener varios patrones separados por espacios o punto y coma. No se distingue entre mayúsculas y minúsculas.

Véase también QRegularExpression::fromWildcard(), entryList() y entryInfoList().

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

Devuelve true si fileName coincide con alguno de los patrones comodín (glob) de la lista de filters; en caso contrario devuelve false. No se distingue entre mayúsculas y minúsculas.

Véase también QRegularExpression::fromWildcard(), entryList() y entryInfoList().

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

Crea un subdirectorio llamado dirName con el valor dado permissions.

Si permissions es std::nullopt (por defecto) esta función establecerá los permisos por defecto.

Devuelve true en caso de éxito; devuelve false si la operación falló o dirName ya existía.

Si dirName ya existía, este método no cambiará sus permisos.

En sistemas POSIX permissions son modificados por la umask (máscara de creación de archivos) del proceso actual, lo que significa que algunos bits de permiso pueden estar desactivados.

En Windows, por defecto, un directorio nuevo hereda sus permisos de su directorio padre. permissions se emulan utilizando ACLs. Estas ACLs pueden estar en orden no canónico cuando al grupo se le conceden menos permisos que a otros. Los archivos y directorios con tales permisos generarán advertencias cuando se abra la pestaña Seguridad del cuadro de diálogo Propiedades. Conceder al grupo todos los permisos concedidos a los demás evita tales advertencias.

Véase también rmdir(), mkpath(), y rmpath().

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

Crea un directorio llamado dirPath.

Si dirPath aún no existe, este método lo creará - junto con cualquier directorio padre inexistente - con permissions.

Si dirPath ya existía, este método no cambiará sus permisos; lo mismo ocurre con cualquier directorio padre ya existente.

Si permissions es std::nullopt (el valor por defecto) esta función establecerá los permisos por defecto.

Devuelve true en caso de éxito o si dirPath ya existía; en caso contrario devuelve false.

En sistemas POSIX permissions es modificado por la umask (máscara de creación de archivos) del proceso actual, lo que significa que algunos bits de permiso pueden estar desactivados.

En Windows, por defecto, un nuevo directorio hereda sus permisos de su directorio padre. permissions se emulan utilizando ACLs. Estas ACLs pueden estar en orden no canónico cuando al grupo se le conceden menos permisos que a otros. Los archivos y directorios con tales permisos generarán advertencias cuando se abra la pestaña Seguridad del cuadro de diálogo Propiedades. Conceder al grupo todos los permisos concedidos a los demás evita tales advertencias.

Véase también rmpath(), mkdir(), y rmdir().

QStringList QDir::nameFilters() const

Devuelve la lista de cadenas establecida por setNameFilters()

Véase también setNameFilters().

QString QDir::path() const

Devuelve la ruta. Puede contener enlaces simbólicos, pero nunca ".", ".." o separadores múltiples redundantes.

La ruta devuelta puede ser absoluta o relativa (véase setPath()).

Véase también setPath(), absolutePath(), exists(), cleanPath(), dirName(), absoluteFilePath(), toNativeSeparators() y makeAbsolute().

void QDir::refresh() const

Actualiza la información del directorio.

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

Devuelve la ruta a fileName relativa al directorio.

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"

Véase también absoluteFilePath(), filePath() y canonicalPath().

bool QDir::remove(const QString &fileName)

Elimina el archivo, fileName.

Devuelve true si el archivo se elimina correctamente; en caso contrario, devuelve false.

bool QDir::removeRecursively()

Elimina el directorio, incluido todo su contenido.

Devuelve true si tiene éxito, en caso contrario devuelve false.

Si no se puede eliminar un archivo o directorio, removeRecursively() sigue adelante e intenta eliminar tantos archivos y subdirectorios como sea posible, luego devuelve false.

Si el directorio ya ha sido eliminado, el método devuelve true (resultado esperado ya alcanzado).

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

Renombra un archivo o directorio de oldName a newName, y devuelve true si tiene éxito; en caso contrario devuelve false.

En la mayoría de los sistemas de archivos, rename() falla sólo si oldName no existe, o si ya existe un archivo con el nuevo nombre. Sin embargo, también hay otras razones por las que rename() puede fallar. Por ejemplo, en al menos un sistema de archivos, rename() falla si newName apunta a un archivo abierto.

Si oldName es un archivo (no un directorio) que no puede ser renombrado inmediatamente, Qt intentará copiar oldName a newName y eliminar oldName.

Véase también QFile::rename().

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

Elimina el directorio especificado por dirName.

El directorio debe estar vacío para que rmdir() tenga éxito.

Devuelve true si tiene éxito; en caso contrario devuelve false.

Véase también mkdir().

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

Elimina la ruta del directorio dirPath.

La función eliminará todos los directorios padre en dirPath, siempre que estén vacíos. Esto es lo contrario de mkpath(dirRuta).

Devuelve true si tiene éxito; en caso contrario devuelve false.

Véase también mkpath().

[static] QDir QDir::root()

Devuelve el directorio raíz.

El directorio se construye utilizando la ruta absoluta del directorio raíz, asegurando que su path() será el mismo que su absolutePath().

Véase rootPath() para más detalles.

Véase también drives(), current(), home(), y temp().

[static] QString QDir::rootPath()

Devuelve la ruta absoluta del directorio raíz.

En los sistemas operativos Unix devuelve "/". En los sistemas operativos Windows, normalmente devuelve "c:/".

Véase también root(), drives(), currentPath(), homePath() y tempPath().

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

Devuelve las rutas de búsqueda de prefix.

Véase también setSearchPaths() y addSearchPath().

[static] QChar QDir::separator()

Devuelve el separador de directorios nativo: "/" en Unix y "\" en Windows.

No es necesario utilizar esta función para construir rutas de archivos. Si siempre usas "/", Qt traducirá tus rutas para ajustarse al sistema operativo subyacente. Si desea mostrar las rutas al usuario utilizando el separador de su sistema operativo utilice toNativeSeparators().

Véase también listSeparator().

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

Establece el directorio de trabajo actual de la aplicación en path. Devuelve true si el directorio se ha cambiado correctamente; en caso contrario, devuelve 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"

Véase también current(), currentPath(), home(), root() y temp().

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

Establece el filtro utilizado por entryList() y entryInfoList() en filters. El filtro se utiliza para especificar el tipo de archivos que deben ser devueltos por entryList() y entryInfoList(). Véase QDir::Filter.

Véase también filter() y setNameFilters().

void QDir::setNameFilters(const QStringList &nameFilters)

Establece los filtros de nombre utilizados por entryList() y entryInfoList() en la lista de filtros especificada por nameFilters.

Cada filtro de nombre es un filtro comodín (globbing) que entiende los comodines * y ?. Véase QRegularExpression::fromWildcard().

Por ejemplo, el siguiente código establece tres filtros de nombre en QDir para garantizar que sólo se enumeran los archivos con las extensiones utilizadas normalmente para los archivos de código fuente C++:

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

Véase también nameFilters() y setFilter().

void QDir::setPath(const QString &path)

Establece la ruta del directorio en path. La ruta se limpia de ".", ".." redundantes y de separadores múltiples. No se comprueba si existe realmente un directorio con esta ruta, pero puede hacerlo usted mismo utilizando exists().

La ruta puede ser absoluta o relativa. Las rutas absolutas comienzan con el separador de directorios "/" (opcionalmente precedido de una especificación de unidad en Windows). Los nombres de archivo relativos comienzan con un nombre de directorio o un nombre de archivo y especifican una ruta relativa al directorio actual. Un ejemplo de ruta absoluta es la cadena "/tmp/quartz"; una ruta relativa podría ser "src/fatlib".

Véase también path(), absolutePath(), exists(), cleanPath(), dirName(), absoluteFilePath(), isRelative() y makeAbsolute().

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

Esta función se introdujo en Qt 6.0.

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

Establece o sustituye las rutas de búsqueda de Qt para nombres de archivo con el prefijo prefix a searchPaths.

Para especificar un prefijo para un nombre de archivo, anteponga el prefijo seguido de dos puntos (por ejemplo, "images:undo.png", "xmldocs:books.xml"). prefix sólo puede contener letras o números (por ejemplo, no puede contener dos puntos ni una barra).

Qt utiliza esta ruta de búsqueda para localizar archivos con un prefijo conocido. Las entradas de la ruta de búsqueda se comprueban en orden, empezando por la primera entrada.

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

El prefijo del nombre del archivo debe tener al menos 2 caracteres para evitar conflictos con las letras de unidad de Windows.

Las rutas de búsqueda pueden contener rutas a The Qt Resource System.

Véase también searchPaths().

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

Establece el orden de clasificación utilizado por entryList() y entryInfoList().

El sort se especifica OR-ing valores del enum QDir::SortFlag.

Véase también sorting() y SortFlag.

QDir::SortFlags QDir::sorting() const

Devuelve el valor establecido por setSorting()

Véase también setSorting() y SortFlag.

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

Intercambia esta instancia de QDir con other. Esta operación es muy rápida y nunca falla.

[static] QDir QDir::temp()

Devuelve el directorio temporal del sistema.

El directorio se construye utilizando la ruta canónica absoluta del directorio temporal, asegurando que su path() será el mismo que su absolutePath().

Véase tempPath() para más detalles.

Véase también drives(), current(), home(), y root().

[static] QString QDir::tempPath()

Devuelve la ruta canónica absoluta del directorio temporal del sistema.

En sistemas Unix/Linux es la ruta de la variable de entorno TMPDIR o /tmp si TMPDIR no está definida. En Windows suele ser la ruta de la variable de entorno TEMP o TMP. La ruta devuelta por este método no termina con un separador de directorio a menos que sea el directorio raíz (de una unidad).

Véase también temp(), currentPath(), homePath() y rootPath().

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

Devuelve pathName con los separadores '/' convertidos a separadores apropiados para el sistema operativo subyacente.

En Windows, toNativeSeparators("c:/winnt/system32") devuelve "c:\winnt\system32 ".

La cadena devuelta puede ser la misma que el argumento en algunos sistemas operativos, por ejemplo en Unix.

Véase también fromNativeSeparators() y separator().

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

Mover-asigna other a esta instancia QDir.

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

Hace una copia del objeto dir y lo asigna a este objeto QDir.

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

Devuelve el nombre de archivo en la posición pos de la lista de nombres de archivo. Equivale a entryList().at(index). pos debe ser una posición de índice válida en la lista (es decir, 0 <= pos < count()).

Véase también count() y entryList().