QTemporaryDir Class

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

Member Function Documentation

QTemporaryDir::QTemporaryDir(const QString &templatePath)

Constructs a QTemporaryDir with a template of templatePath.

If templatePath is a relative path, the path will be relative to the current working directory. You can use QDir::tempPath() to construct templatePath if you want use the system's temporary directory.

If the templatePath ends with XXXXXX it will be used as the dynamic portion of the directory name, otherwise it will be appended. Unlike QTemporaryFile, XXXXXX in the middle of the template string is not supported.

See also QDir::tempPath().

QTemporaryDir::QTemporaryDir()

Constructs a QTemporaryDir using as template the application name returned by QCoreApplication::applicationName() (otherwise qt_temp). The directory is stored in the system's temporary directory, QDir::tempPath().

See also QDir::tempPath().

QTemporaryDir::~QTemporaryDir()

Destroys the temporary directory object. If auto remove mode was set, it will automatically delete the directory including all its contents.

See also autoRemove().

bool QTemporaryDir::autoRemove() const

Returns true if the QTemporaryDir is in auto remove mode. Auto-remove mode will automatically delete the directory from disk upon destruction. This makes it very easy to create your QTemporaryDir object on the stack, fill it with files, do something with the files, and finally on function return it will automatically clean up after itself.

Auto-remove is on by default.

See also setAutoRemove() and remove().

QString QTemporaryDir::errorString() const

If isValid() returns false, this function returns the error string that explains why the creation of the temporary directory failed. Otherwise, this function return an empty string.

This function was introduced in Qt 5.6.

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

Returns the path name of a file in the temporary directory. Does not check if the file actually exists in the directory. Redundant multiple separators or "." and ".." directories in fileName are not removed (see QDir::cleanPath()). Absolute paths are not allowed.

This function was introduced in Qt 5.9.

bool QTemporaryDir::isValid() const

Returns true if the QTemporaryDir was created successfully.

QString QTemporaryDir::path() const

Returns the path to the temporary directory. Empty if the QTemporaryDir could not be created.

bool QTemporaryDir::remove()

Removes the temporary directory, including all its contents.

Returns true if removing was successful.

void QTemporaryDir::setAutoRemove(bool b)

Sets the QTemporaryDir into auto-remove mode if b is true.

Auto-remove is on by default.

See also autoRemove() and remove().