En esta página

QTemporaryDir Class

La clase QTemporaryDir crea un directorio único para uso temporal. Más...

Cabecera: #include <QTemporaryDir>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son reentrantes.

Funciones Públicas

QTemporaryDir()
QTemporaryDir(const QString &templatePath)
(since 6.4) QTemporaryDir(QTemporaryDir &&other)
~QTemporaryDir()
bool autoRemove() const
QString errorString() const
QString filePath(const QString &fileName) const
bool isValid() const
QString path() const
bool remove()
void setAutoRemove(bool b)
(since 6.4) void swap(QTemporaryDir &other)
(since 6.4) QTemporaryDir &operator=(QTemporaryDir &&other)

Descripción Detallada

QTemporaryDir se utiliza para crear directorios temporales únicos de forma segura. El directorio es creado por el constructor. Se garantiza que el nombre del directorio temporal es único (es decir, se garantiza que no se sobrescribirá un directorio existente), y el directorio será eliminado posteriormente al destruir el objeto QTemporaryDir. El nombre del directorio se genera automáticamente, o se crea basándose en una plantilla, que se pasa al constructor de QTemporaryDir.

Ejemplo:

    // Within a function/method...

    QTemporaryDir dir;
    if (dir.isValid()) {
        // dir.path() returns the unique directory path
    }

    // The QTemporaryDir destructor removes the temporary directory
    // as it goes out of scope.

Es muy importante probar que el directorio temporal puede ser creado, usando isValid(). No utilice exists(), ya que un constructor por defecto QDir representa el directorio actual, que existe.

La ruta al directorio temporal se puede encontrar llamando a path().

Un directorio temporal tendrá alguna parte estática del nombre y alguna parte que se calcula para que sea única. La ruta por defecto se determinará a partir de QCoreApplication::applicationName() (en caso contrario qt_temp) y se colocará en la ruta temporal devuelta por QDir::tempPath(). Si especifica su propia ruta, no se colocará una ruta relativa en el directorio temporal por defecto, sino que será relativa al directorio de trabajo actual. En todos los casos, se añadirá una cadena aleatoria a la ruta para hacerla única.

Véase también QDir::tempPath(), QDir, y QTemporaryFile.

Documentación de las funciones miembro

QTemporaryDir::QTemporaryDir()

Construye un QTemporaryDir utilizando como plantilla el nombre de la aplicación devuelto por QCoreApplication::applicationName() (en caso contrario qt_temp). El directorio se almacena en el directorio temporal del sistema, QDir::tempPath().

Ver también QDir::tempPath().

[explicit] QTemporaryDir::QTemporaryDir(const QString &templatePath)

Construye un QTemporaryDir con una plantilla de templatePath.

Si templatePath es una ruta relativa, la ruta será relativa al directorio de trabajo actual. Puedes usar QDir::tempPath() para construir templatePath si quieres usar el directorio temporal del sistema.

Si templatePath termina con XXXXXX se utilizará como la parte dinámica del nombre del directorio, de lo contrario se añadirá. A diferencia de QTemporaryFile, no se admite XXXXXX en medio de la cadena de plantilla.

Véase también QDir::tempPath().

[noexcept, since 6.4] QTemporaryDir::QTemporaryDir(QTemporaryDir &&other)

Move-construye un nuevo QTemporaryDir a partir de other.

Nota: El objeto movido-desde other se coloca en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

Esta función se introdujo en Qt 6.4.

[noexcept] QTemporaryDir::~QTemporaryDir()

Destruye el objeto directorio temporal. Si se ha establecido el modo de eliminación automática, borrará automáticamente el directorio incluyendo todo su contenido.

Véase también autoRemove().

bool QTemporaryDir::autoRemove() const

Devuelve true si QTemporaryDir está en modo de eliminación automática. El modo de auto-eliminación borrará automáticamente el directorio del disco al ser destruido. Esto hace que sea muy fácil crear su objeto QTemporaryDir en la pila, llenarlo con archivos, hacer algo con los archivos, y, finalmente, en la función de retorno se limpiará automáticamente después de sí mismo.

La eliminación automática está activada por defecto.

Ver también setAutoRemove() y remove().

QString QTemporaryDir::errorString() const

Si isValid() devuelve false, esta función devuelve la cadena de error que explica por qué falló la creación del directorio temporal. En caso contrario, esta función devuelve una cadena vacía.

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

Devuelve el nombre de la ruta de un archivo en el directorio temporal. No comprueba si el fichero existe realmente en el directorio. Los separadores múltiples redundantes o los directorios "." y ".." en fileName no se eliminan (véase QDir::cleanPath()). No se permiten las rutas absolutas.

La ruta devuelta será relativa o absoluta dependiendo de si QTemporaryDir se construyó con una ruta relativa o absoluta, respectivamente.

bool QTemporaryDir::isValid() const

Devuelve true si QTemporaryDir se ha creado correctamente.

QString QTemporaryDir::path() const

Devuelve la ruta al directorio temporal. Vacío si no se ha podido crear QTemporaryDir.

La ruta devuelta será relativa o absoluta dependiendo de si QTemporaryDir se construyó con una ruta relativa o absoluta, respectivamente.

bool QTemporaryDir::remove()

Elimina el directorio temporal, incluyendo todo su contenido.

Devuelve true si la eliminación se ha realizado correctamente.

void QTemporaryDir::setAutoRemove(bool b)

Pone QTemporaryDir en modo de eliminación automática si b es verdadero.

La eliminación automática está activada por defecto.

Véase también autoRemove() y remove().

[noexcept, since 6.4] void QTemporaryDir::swap(QTemporaryDir &other)

Cambia este directorio temporal por other. Esta operación es muy rápida y nunca falla.

Esta función se introdujo en Qt 6.4.

[noexcept, since 6.4] QTemporaryDir &QTemporaryDir::operator=(QTemporaryDir &&other)

Mover-asigna other a esta instancia QTemporaryDir.

Nota: El objeto movido-desde other se coloca en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

Esta función se introdujo en Qt 6.4.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.