En esta página

QTemporaryDir Class

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

Encabezado: #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 propio directorio lo crea el constructor. Se garantiza que el nombre del directorio temporal sea único (es decir, se garantiza que no se sobrescribirá ningún directorio existente) y que dicho directorio se elimine posteriormente al destruirse el objeto QTemporaryDir. El nombre del directorio se genera automáticamente o se crea a partir de 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 comprobar que se pueda crear el directorio temporal utilizando ` isValid()`. No utilices ` exists()`, ya que un ` QDir ` construido por defecto representa el directorio actual, que ya existe.

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

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

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

Documentación de funciones miembro

QTemporaryDir::QTemporaryDir()

Crea un objeto `QTemporaryDir` utilizando como plantilla el nombre de la aplicación devuelto por ` QCoreApplication::applicationName()` (o, en su defecto, ` qt_temp`). El directorio se almacena en el directorio temporal del sistema, ` QDir::tempPath()`.

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

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

Crea un objeto `QTemporaryDir` con la plantilla ` templatePath`.

Si templatePath es una ruta relativa, esta se referirá al directorio de trabajo actual. Puedes utilizar QDir::tempPath() para crear templatePath si deseas utilizar el directorio temporal del sistema.

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

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

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

Crea un nuevo objeto `QTemporaryDir` a partir de ` other`.

Nota: El objeto del que se ha realizado el traslado ( other ) queda 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()

Elimina el objeto del directorio temporal. Si se ha activado el modo de eliminación automática, se borrará automáticamente el directorio, incluido todo su contenido.

Véase también autoRemove().

bool QTemporaryDir::autoRemove() const

Devuelve ` true ` si el objeto ` QTemporaryDir ` está en modo de eliminación automática. El modo de eliminación automática borrará automáticamente el directorio del disco al destruirse el objeto. Esto facilita mucho crear el objeto ` QTemporaryDir ` en la pila, llenarlo de archivos, realizar alguna operación con ellos y, finalmente, al retornar de la función, el objeto se limpiará automáticamente por sí mismo.

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

Véase 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é ha fallado 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 la ruta de un archivo en el directorio temporal. No comprueba si el archivo existe realmente en el directorio. No se eliminan los separadores múltiples redundantes ni los directorios «.» y «..» en fileName (véase QDir::cleanPath()). No se admiten 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 se ha creado correctamente el « QTemporaryDir ».

QString QTemporaryDir::path() const

Devuelve la ruta al directorio temporal. Vuelve un valor vacío si no se ha podido crear el objeto ` QTemporaryDir `.

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

bool QTemporaryDir::remove()

Elimina el directorio temporal, incluido todo su contenido.

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

void QTemporaryDir::setAutoRemove(bool b)

Activa el modo de eliminación automática de « QTemporaryDir » si « b » es «true».

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

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

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

Sustituye 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)

La operación «move-assigns» asigna other a esta instancia de QTemporaryDir.

Nota: El objeto del que se realiza el traslado, ` other `, pasa a 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.