QTemporaryFile 类

成员函数文档

QTemporaryFile::QTemporaryFile()

使用由QCoreApplication::applicationName()返回的应用程序名称（否则为qt_temp）后跟".XXXXXX"作为文件模板构造 QTemporaryFile。文件存储在系统的临时目录中，即QDir::tempPath。

另请参阅setFileTemplate()和QDir::tempPath。

[显式] QTemporaryFile::QTemporaryFile(const QString &templateName)

使用模板文件名templateName构造 QTemporaryFile。在打开临时文件时，将使用此名称创建一个唯一的文件名。

如果templateName不包含XXXXXX，它将自动附加并用作文件名的动态部分。

如果 templateName 是一个相对路径，该路径将相对于当前工作目录。如果您想使用系统的临时目录，可以使用 QDir::tempPath() 来构造 templateName。如果将调用rename() 函数，确保指定正确的目录是重要的，因为 QTemporaryFile 只能重命名与临时文件本身所创建的同一卷 / 文件系统中的文件。

另请参阅 open() 以及 fileTemplate。

[显式] QTemporaryFile::QTemporaryFile(QObject *parent)

使用 QCoreApplication::applicationName() 返回的（否则为 qt_temp）应用程序名称作为文件模板，后跟 ".XXXXXX" 来构造一个 QTemporaryFile（带有给定的 parent）。文件存储在系统的临时目录 QDir::tempPath() 中。

另请参阅 setFileTemplate。

QTemporaryFile::QTemporaryFile(const QString &templateName, QObject *parent)

使用文件模板 templateName 和指定的 parent 来构造一个 QTemporaryFile。在打开临时文件时，将使用此模板创建一个唯一的文件名。

如果templateName不包含XXXXXX，它将自动附加并用作文件名的动态部分。

如果 templateName 是一个相对路径，该路径将相对于当前工作目录。如果您想使用系统的临时目录，可以使用 QDir::tempPath() 来构造 templateName。如果将调用rename() 函数，确保指定正确的目录是重要的，因为 QTemporaryFile 只能重命名与临时文件本身所创建的同一卷 / 文件系统中的文件。

另请参阅 open() 以及 fileTemplate。

[显式，自 6.7 版本起] QTemporaryFile::QTemporaryFile(const std::filesystem::path &templateName, QObject *parent = nullptr)

这是一个重载函数。

此函数是在 Qt 6.7 中引入的。

[虚，noexcept] QTemporaryFile::~QTemporaryFile()

销毁临时文件对象，如果需要并且处于自动删除模式，将自动删除文件。

另请参阅 autoRemove。

bool QTemporaryFile::autoRemove() const

如果 QTemporaryFile 处于自动删除模式，则返回 true。自动删除模式在销毁时将自动从磁盘删除文件名。这使得在堆栈上创建您的 QTemporaryFile 对象、填充数据、读取数据，最后在函数返回时自动清理变得非常简单。

默认情况下自动删除是开启的。

另请参阅 setAutoRemove 和 remove。

[静态] QTemporaryFile *QTemporaryFile::createNativeFile(QFile &file)

如果 file 还不是一个原生文件，则在 QDir::tempPath() 中创建一个 QTemporaryFile，将 file 的内容复制进去，并返回临时文件的指针。如果 file 已经是一个原生文件，则不执行任何操作并返回 0。

例如

  QFile f(":/resources/file.txt");
  QTemporaryFile::createNativeFile(f); // Returns a pointer to a temporary file

  QFile f("/users/qt/file.txt");
  QTemporaryFile::createNativeFile(f); // Returns 0

另请参阅 QFileInfo::isNativePath。

[静态] QTemporaryFile *QTemporaryFile::createNativeFile(const QString &fileName)

这是一个重载函数。

在给定的 fileName 上工作，而不是现有的 QFile 对象。

[静态，自 6.7 版本起] QTemporaryFile *QTemporaryFile::createNativeFile(const std::filesystem::path &fileName)

这是一个重载函数。

此函数是在 Qt 6.7 中引入的。

[重写虚函数] QString QTemporaryFile::fileName() const

重实： QFile::fileName() const.

返回支撑 QTemporaryFile 对象的唯一完整文件名。在打开 QTemporaryFile 之前，此字符串为空，之后它将包含 fileTemplate() 加上一些使其唯一的额外字符。

参见 fileTemplate().

QString QTemporaryFile::fileTemplate() const

返回设置的文件模板。默认文件模板名为 qcoreappname.XXXXXX，并位于 QDir::tempPath()。

另请参阅 setFileTemplate。

bool QTemporaryFile::open()

QTemporaryFile 总是在 QIODevice::ReadWrite 模式下打开，这使得轻松访问文件中的数据。此函数成功时返回 true，并将 fileName() 设置为使用的唯一文件名。

参见 fileName().

[重写虚保护函数] bool QTemporaryFile::open(QIODeviceBase::OpenMode flags)

重实： QFile::open(QIODeviceBase::OpenMode mode).

为临时文件创建唯一文件名，并打开它。您可以通过调用 fileName() 在以后获取唯一名称。该文件确保被此函数创建（即，它以前从未存在过）。

bool QTemporaryFile::rename(const QString &newName)

将当前临时文件重命名为 newName，如果成功则返回 true。

此函数与 QFile::rename 有一个重要的区别：如果低级系统调用重命名文件失败（这可能发生在 newName 指定了一个与临时文件创建在的不同卷或文件系统中的文件时），它不会执行复制+删除操作。换句话说，QTemporaryFile 只支持原子的文件重命名。

此功能旨在支持以所有内容都存在的方式实现目标文件，因此另一个进程无法看到正在写入过程中不完整的文件。QSaveFile 类也可以用于类似目的，尤其是如果目标文件不是临时文件的话。

参见 QSaveFile，QSaveFile::commit()，和 QFile::rename().

[自 6.7 版本起] bool QTemporaryFile::rename(const std::filesystem::path &newName)

这是一个重载函数。

此函数是在 Qt 6.7 中引入的。

void QTemporaryFile::setAutoRemove(bool b)

如果 b 为 true，则将 QTemporaryFile 设置为自动删除模式。

默认情况下自动删除是开启的。

如果您将此属性设置为 true，请确保应用程序能够在不再需要文件时提供删除文件的方式，包括将责任转移到另一个进程。始终使用 fileName() 函数来获取名称，切勿尝试猜测 QTemporaryFile 生成的名称。

在某些系统上，如果在关闭文件之前没有调用 fileName()，则无论此属性的状态如何，临时文件可能会被删除。不应依赖于这种行为，因此应用程序代码应该调用 fileName() 或启用自动删除功能。

另请参阅autoRemove() 和 remove()。

void QTemporaryFile::setFileTemplate(const QString &name)

将文件名静态部分设置为 name。如果文件模板包含 XXXXXX，则将自动替换为文件名的唯一部分；否则，将根据指定的静态部分自动确定文件名。

如果 name 包含相对文件路径，则路径相对于当前工作目录。如果您想使用系统的临时目录，可以使用 QDir::tempPath() 构造 name。如果将调用 rename() 函数，请指定正确的目录，因为 QTemporaryFile 只能将其本身创建的临时文件重命名到同一卷/文件系统内部。

参见 fileTemplate().

[since 6.7] void QTemporaryFile::setFileTemplate(const std::filesystem::path &name)

这是一个重载函数。

此函数是在 Qt 6.7 中引入的。