QTemporaryFile Class
La clase `QTemporaryFile` es un dispositivo de E/S que opera con archivos temporales. Más información...
| Encabezado: | #include <QTemporaryFile> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredado de: | QFile |
- Lista de todos los miembros, incluidos los heredados
- QTemporaryFile forma parte de Entrada/Salida y Redes.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| QTemporaryFile() | |
| QTemporaryFile(QObject *parent) | |
| QTemporaryFile(const QString &templateName) | |
| QTemporaryFile(const QString &templateName, QObject *parent) | |
(since 6.7) | QTemporaryFile(const std::filesystem::path &templateName, QObject *parent = nullptr) |
| virtual | ~QTemporaryFile() |
| bool | autoRemove() const |
| QString | fileTemplate() const |
| bool | open() |
| bool | rename(const QString &newName) |
(since 6.7) bool | rename(const std::filesystem::path &newName) |
(since 6.11) bool | renameOverwrite(const QString &newName) |
(since 6.11) bool | renameOverwrite(const std::filesystem::path &newName) |
| void | setAutoRemove(bool b) |
| void | setFileTemplate(const QString &templateName) |
(since 6.7) void | setFileTemplate(const std::filesystem::path &name) |
Funciones públicas reimplementadas
| virtual QString | fileName() const override |
Miembros públicos estáticos
| QTemporaryFile * | createNativeFile(QFile &file) |
| QTemporaryFile * | createNativeFile(const QString &fileName) |
(since 6.7) QTemporaryFile * | createNativeFile(const std::filesystem::path &fileName) |
Funciones protegidas reimplementadas
| virtual bool | open(QIODeviceBase::OpenMode mode) override |
Descripción detallada
open se utiliza para crear archivos temporales únicos de forma segura. El archivo en sí se crea llamando a (). Se garantiza que el nombre del archivo temporal sea único (es decir, se garantiza que no se sobrescribirá ningún archivo existente) y, posteriormente, el archivo se eliminará al destruirse el objeto QTemporaryFile. Se trata de una técnica importante que evita la corrupción de datos en aplicaciones que almacenan información en archivos temporales. El nombre del archivo se genera automáticamente o se crea a partir de una plantilla, que se pasa al constructor de QTemporaryFile.
Ejemplo:
// Within a function/method...
QTemporaryFile file;
if (file.open()) {
// file.fileName() returns the unique file name
}
// The QTemporaryFile destructor removes the temporary file
// as it goes out of scope.Volver a abrir un `QTemporaryFile` tras llamar a ` close()` es seguro. Mientras el objeto `QTemporaryFile` no se destruya, el archivo temporal único seguirá existiendo y se mantendrá abierto internamente por `QTemporaryFile`.
El nombre del archivo temporal se puede obtener llamando a ` fileName()`. Ten en cuenta que este solo se define tras la primera apertura del archivo; antes de ello, la función devuelve una cadena vacía.
Un archivo temporal tendrá una parte estática del nombre y otra parte que se calcula para que sea única. El nombre de archivo 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 se especifica un nombre de archivo propio, por defecto no se colocará una ruta de archivo relativa en el directorio temporal, sino que será relativa al directorio de trabajo actual.
Es importante especificar el directorio correcto si se va a llamar a la función rename(), ya que QTemporaryFile solo puede renombrar archivos dentro del mismo volumen o sistema de archivos en el que se creó el propio archivo temporal.
El nombre del archivo (la parte que sigue al último separador de ruta de directorio en la plantilla de archivo especificada) puede contener la secuencia especial "XXXXXX" (al menos seis caracteres en mayúsculas "X" ), que se sustituirá por la parte generada automáticamente del nombre del archivo. Si el nombre del archivo no contiene "XXXXXX", QTemporaryFile añadirá la parte generada al nombre del archivo. Solo se tendrá en cuenta la última aparición de « "XXXXXX" ».
Nota: En Linux, QTemporaryFile intentará crear archivos temporales sin nombre. Si lo consigue, open() devolverá «true», pero exists() devolverá «false». Si se llama a fileName() o a cualquier función que la llame, QTemporaryFile asignará un nombre al archivo, por lo que la mayoría de las aplicaciones no notarán ninguna diferencia.
Véase también QDir::tempPath() y QFile.
Documentación de las funciones miembro
QTemporaryFile::QTemporaryFile()
Crea un objeto `QTemporaryFile`.
La plantilla predeterminada del nombre de archivo se determina a partir del nombre de la aplicación, tal y como lo devuelve QCoreApplication::applicationName() (o "qt_temp" si el nombre de la aplicación está vacío), seguido de ".XXXXXX". El archivo se almacena en el directorio temporal del sistema, tal y como lo devuelve QDir::tempPath().
Véanse también setFileTemplate(), fileTemplate(), fileName() y QDir::tempPath().
[explicit] QTemporaryFile::QTemporaryFile(QObject *parent)
Crea un objeto `QTemporaryFile` con el ` parent` indicado.
La plantilla predeterminada del nombre del archivo se determina a partir del nombre de la aplicación, tal y como lo devuelve QCoreApplication::applicationName() (o "qt_temp" si el nombre de la aplicación está vacío), seguido de ".XXXXXX". El archivo se almacena en el directorio temporal del sistema, tal y como lo devuelve QDir::tempPath().
Véase también setFileTemplate().
[explicit] QTemporaryFile::QTemporaryFile(const QString &templateName)
Crea un objeto `QTemporaryFile` utilizando ` templateName ` como plantilla para el nombre del archivo.
Al abrir el archivo temporal, se utilizará templateName para crear un nombre de archivo único.
Si el nombre del archivo (la parte que sigue al último separador de ruta de directorio en templateName) no contiene "XXXXXX", se añadirá automáticamente.
"XXXXXX" se sustituirá por la parte dinámica del nombre de archivo, que se calcula para que sea único.
Si templateName es una ruta relativa, la ruta será relativa al directorio de trabajo actual. Puedes utilizar QDir::tempPath() para construir templateName si deseas utilizar el directorio temporal del sistema.
Es importante especificar el directorio correcto si se va a llamar a la función rename(), ya que QTemporaryFile solo puede renombrar archivos dentro del mismo volumen o sistema de archivos en el que se creó el propio archivo temporal.
Véanse también open() y fileTemplate().
QTemporaryFile::QTemporaryFile(const QString &templateName, QObject *parent)
Crea un objeto `QTemporaryFile` con el ` parent` especificado y ` templateName ` como plantilla para el nombre del archivo.
Al abrir el archivo temporal, se utilizará templateName para crear un nombre de archivo único.
Si el nombre del archivo (la parte que sigue al último separador de ruta de directorio en templateName) no contiene "XXXXXX", se añadirá automáticamente.
"XXXXXX" se sustituirá por la parte dinámica del nombre de archivo, que se calcula para que sea único.
Si templateName es una ruta relativa, la ruta será relativa al directorio de trabajo actual. Puedes utilizar QDir::tempPath() para construir templateName si deseas utilizar el directorio temporal del sistema. Es importante especificar el directorio correcto si se va a llamar a la función rename(), ya que QTemporaryFile solo puede renombrar archivos dentro del mismo volumen o sistema de archivos en el que se creó el propio archivo temporal.
Véase también open() y fileTemplate().
[explicit, since 6.7] QTemporaryFile::QTemporaryFile(const std::filesystem::path &templateName, QObject *parent = nullptr)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.7.
[virtual noexcept] QTemporaryFile::~QTemporaryFile()
Elimina el objeto de archivo temporal; el archivo se cierra automáticamente si es necesario y, si se encuentra en modo de eliminación automática, se borrará automáticamente.
Véase también autoRemove().
bool QTemporaryFile::autoRemove() const
Devuelve ` true ` si el objeto ` QTemporaryFile ` se encuentra en modo de eliminación automática. El modo de eliminación automática borrará automáticamente el nombre del archivo del disco tras su destrucción. Esto facilita enormemente la creación de un objeto ` QTemporaryFile ` en la pila, rellenarlo con datos, leer de él y, finalmente, al regresar de la función, se limpiará automáticamente por sí mismo.
La eliminación automática está activada por defecto.
Véase también setAutoRemove() y remove().
[static] QTemporaryFile *QTemporaryFile::createNativeFile(QFile &file)
Si file aún no es un archivo nativo, se crea un QTemporaryFile en QDir::tempPath(), se copia en él el contenido de file y se devuelve un puntero al archivo temporal. No realiza ninguna acción y devuelve 0 si file ya es un archivo nativo.
Por ejemplo:
QFile f_pointer(":/resources/file.txt");
QTemporaryFile::createNativeFile(f_pointer); // Returns a pointer to a temporary file
QFile f0("/users/qt/file.txt");
QTemporaryFile::createNativeFile(f0); // Returns 0Véase también QFileInfo::isNativePath().
[static] QTemporaryFile *QTemporaryFile::createNativeFile(const QString &fileName)
Funciona con el objeto ` fileName ` proporcionado, en lugar de con un objeto ` QFile ` ya existente.
Se trata de una función sobrecargada.
[static, since 6.7] QTemporaryFile *QTemporaryFile::createNativeFile(const std::filesystem::path &fileName)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.7.
[override virtual] QString QTemporaryFile::fileName() const
Reimplementa: QFile::fileName() const.
Devuelve el nombre de archivo completo y único asociado al objeto ` QTemporaryFile `. Esta cadena es nula antes de que se abra el ` QTemporaryFile `; a partir de ese momento, contendrá el resultado de ` fileTemplate()` más caracteres adicionales para que sea único.
El nombre de archivo devuelto por este método es relativo o absoluto, dependiendo de si la plantilla de nombre de archivo utilizada para construir este objeto (o pasada a setFileTemplate()) es relativa o absoluta, respectivamente.
Véase también fileTemplate().
QString QTemporaryFile::fileTemplate() const
Devuelve la plantilla de nombre de archivo.
La plantilla de nombre de archivo devuelta por este método será relativa o absoluta, dependiendo de si la plantilla de nombre de archivo utilizada para construir este objeto (o pasada a setFileTemplate()) es relativa o absoluta, respectivamente.
Véase también setFileTemplate(), fileName() y Default File Name Template.
bool QTemporaryFile::open()
Abre un archivo temporal único en el sistema de archivos en modo « QIODeviceBase::ReadWrite ». Devuelve « true » si el archivo se ha abierto correctamente o si ya estaba abierto. En caso contrario, devuelve « false ».
Si se invoca por primera vez, open() creará un nombre de archivo único basado en fileTemplate(). Se garantiza que el archivo ha sido creado por esta función (es decir, que nunca ha existido antes).
Si se vuelve a abrir un archivo tras llamar a close(), se abrirá de nuevo el mismo archivo.
Véanse también « setFileTemplate()» y « QT_USE_NODISCARD_FILE_OPEN ».
[override virtual protected] bool QTemporaryFile::open(QIODeviceBase::OpenMode mode)
Reimplementa: ` QFile::open` (modo `QIODeviceBase::OpenMode`).
Abre un archivo temporal único en el sistema de archivos con los indicadores de mode. Devuelve true si el archivo se ha abierto correctamente o si ya estaba abierto. En caso contrario, devuelve false.
Si se invoca por primera vez, open() creará un nombre de archivo único basado en fileTemplate(), y lo abrirá con los indicadores mode. Se garantiza que el archivo ha sido creado por esta función (es decir, nunca ha existido antes).
Si se vuelve a abrir un archivo tras llamar a close(), se volverá a abrir el mismo archivo con los indicadores mode.
Véase también setFileTemplate() y QT_USE_NODISCARD_FILE_OPEN.
bool QTemporaryFile::rename(const QString &newName)
Cambia el nombre del archivo temporal actual a « newName » y devuelve «true» si la operación se ha realizado con éxito.
Esta función presenta una diferencia importante con respecto a QFile::rename(): no realizará una operación de «copiar y eliminar» si falla la llamada al sistema de bajo nivel para renombrar el archivo, algo que podría ocurrir si newName especifica un archivo en un volumen o sistema de archivos diferente al que se creó el archivo temporal. En otras palabras, QTemporaryFile solo admite el renombrado atómico de archivos.
Esta funcionalidad tiene por objeto garantizar que el archivo de destino se cree con todo su contenido ya presente, de modo que ningún otro proceso pueda ver un archivo incompleto en proceso de escritura. La clase QSaveFile también puede utilizarse con un fin similar, especialmente si el archivo de destino no es temporal.
Nota: Llamar a rename() no desactiva autoRemove. Si deseas que el archivo renombrado persista, debes llamar a setAutoRemove y establecerlo en false después de llamar a rename(). De lo contrario, el archivo se eliminará cuando se destruya el objeto QTemporaryFile.
Esta función fallará si ya existe newName. Para sustituirlo, utiliza renameOverwrite() en su lugar.
Véase también renameOverwrite(), QSaveFile, QSaveFile::commit() y QFile::rename().
[since 6.7] bool QTemporaryFile::rename(const std::filesystem::path &newName)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.7.
[since 6.11] bool QTemporaryFile::renameOverwrite(const QString &newName)
Es lo mismo que « rename()», salvo que sustituye de forma atómica « newName » si ya existe, al igual que hace « QSaveFile::commit()».
Devuelve false si el cambio de nombre no se ha podido realizar de forma atómica (por ejemplo, si el archivo temporal y el nombre del archivo de destino se encuentran en sistemas de archivos, volúmenes o unidades diferentes).
Esta función se introdujo en Qt 6.11.
Véase también rename(), QSaveFile, QSaveFile::commit() y QFile::rename().
[since 6.11] bool QTemporaryFile::renameOverwrite(const std::filesystem::path &newName)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.11.
void QTemporaryFile::setAutoRemove(bool b)
Activa el modo de eliminación automática de « QTemporaryFile » si « b » es « true ».
La eliminación automática está activada de forma predeterminada.
Si se establece esta propiedad en ` false`, hay que asegurarse de que la aplicación ofrezca una forma de eliminar el archivo una vez que ya no sea necesario, lo que incluye delegar la responsabilidad a otro proceso. Utilice siempre la función ` fileName()` para obtener el nombre y nunca intente adivinar el nombre que ha generado ` QTemporaryFile `.
En algunos sistemas, si no se llama a fileName() antes de cerrar el archivo, es posible que el archivo temporal se elimine independientemente del estado de esta propiedad. No se debe confiar en este comportamiento, por lo que el código de la aplicación debe llamar a fileName() o dejar activada la función de eliminación automática.
Véase también ` autoRemove()` y ` remove()`.
void QTemporaryFile::setFileTemplate(const QString &templateName)
Establece la plantilla del nombre de archivo en templateName.
Si el nombre del archivo (la parte que aparece tras el último separador de ruta de directorio en templateName) no contiene "XXXXXX", se añadirá automáticamente.
"XXXXXX" se sustituirá por la parte dinámica del nombre de archivo, que se calcula para que sea única.
Si templateName es una ruta relativa, la ruta será relativa al directorio de trabajo actual. Puedes utilizar QDir::tempPath() para construir templateName si deseas utilizar el directorio temporal del sistema. Es importante especificar el directorio correcto si se va a llamar a la función rename(), ya que QTemporaryFile solo puede renombrar archivos dentro del mismo volumen o sistema de archivos en el que se creó el propio archivo temporal.
Véase también fileTemplate() y fileName().
[since 6.7] void QTemporaryFile::setFileTemplate(const std::filesystem::path &name)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.7.
© 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.