Revision control
Copy as Markdown
// Copyright (C) 2017 The Qt Company Ltd.
// Copyright (C) 2017 Intel Corporation.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
// Qt-Security score:significant reason:default
#include "qtemporarydir.h"
#if QT_CONFIG(temporaryfile)
#include "qdebug.h"
#include "qplatformdefs.h"
#include "qrandom.h"
#include "private/qtemporaryfile_p.h"
#if defined(QT_BUILD_CORE_LIB)
#include "qcoreapplication.h"
#endif
#if !defined(Q_OS_WIN)
#include <errno.h>
#endif
#include <type_traits>
QT_BEGIN_NAMESPACE
using namespace Qt::StringLiterals;
static_assert(std::is_nothrow_move_constructible_v<QTemporaryDir>);
static_assert(std::is_nothrow_move_assignable_v<QTemporaryDir>);
//************* QTemporaryDirPrivate
class QTemporaryDirPrivate
{
public:
QTemporaryDirPrivate();
~QTemporaryDirPrivate();
void create(const QString &templateName);
QString pathOrError;
bool autoRemove;
bool success;
};
QTemporaryDirPrivate::QTemporaryDirPrivate()
: autoRemove(true),
success(false)
{
}
QTemporaryDirPrivate::~QTemporaryDirPrivate()
{
}
static QString defaultTemplateName()
{
QString baseName;
#if defined(QT_BUILD_CORE_LIB)
baseName = QCoreApplication::applicationName();
if (baseName.isEmpty())
#endif
baseName = "qt_temp"_L1;
return QDir::tempPath() + u'/' + baseName + "-XXXXXX"_L1;
}
void QTemporaryDirPrivate::create(const QString &templateName)
{
QTemporaryFileName tfn(templateName);
constexpr auto perms = QFile::ReadOwner | QFile::WriteOwner | QFile::ExeOwner;
for (int i = 0; i < 256; ++i) {
tfn.generateNext();
QFileSystemEntry fileSystemEntry(tfn.path, QFileSystemEntry::FromNativePath());
if (QFileSystemEngine::mkdir(fileSystemEntry, perms)) {
success = true;
pathOrError = fileSystemEntry.filePath();
return;
}
# ifdef Q_OS_WIN
const int exists = ERROR_ALREADY_EXISTS;
int code = GetLastError();
# else
const int exists = EEXIST;
int code = errno;
# endif
if (code != exists)
break;
}
pathOrError = qt_error_string();
success = false;
}
//************* QTemporaryDir
/*!
\class QTemporaryDir
\inmodule QtCore
\reentrant
\brief The QTemporaryDir class creates a unique directory for temporary use.
\ingroup io
QTemporaryDir is used to create unique temporary directories safely.
The directory itself is created by the constructor. The name of the
temporary directory is guaranteed to be unique (i.e., you are
guaranteed to not overwrite an existing directory), and the directory will
subsequently be removed upon destruction of the QTemporaryDir
object. The directory name is either auto-generated, or created based
on a template, which is passed to QTemporaryDir's constructor.
Example:
\snippet code/src_corelib_io_qtemporarydir.cpp 0
It is very important to test that the temporary directory could be
created, using isValid(). Do not use \l {QDir::exists()}{exists()}, since a default-constructed
QDir represents the current directory, which exists.
The path to the temporary directory can be found by calling path().
A temporary directory will have some static part of the name and some
part that is calculated to be unique. The default path will be
determined from QCoreApplication::applicationName() (otherwise \c qt_temp) and will
be placed into the temporary path as returned by QDir::tempPath().
If you specify your own path, a relative path will not be placed in the
temporary directory by default, but be relative to the current working directory.
In all cases, a random string will be appended to the path in order to make it unique.
\sa QDir::tempPath(), QDir, QTemporaryFile
*/
/*!
Constructs a QTemporaryDir using as template the application name
returned by QCoreApplication::applicationName() (otherwise \c qt_temp).
The directory is stored in the system's temporary directory, QDir::tempPath().
\sa QDir::tempPath()
*/
QTemporaryDir::QTemporaryDir()
: d_ptr(new QTemporaryDirPrivate)
{
d_ptr->create(defaultTemplateName());
}
/*!
Constructs a QTemporaryDir with a template of \a templatePath.
If \a templatePath is a relative path, the path will be relative to the
current working directory. You can use QDir::tempPath() to construct \a
templatePath if you want use the system's temporary directory.
If the \a 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.
\sa QDir::tempPath()
*/
QTemporaryDir::QTemporaryDir(const QString &templatePath)
: d_ptr(new QTemporaryDirPrivate)
{
if (templatePath.isEmpty())
d_ptr->create(defaultTemplateName());
else
d_ptr->create(templatePath);
}
/*!
\fn QTemporaryDir::QTemporaryDir(QTemporaryDir &&other)
Move-constructs a new QTemporaryDir from \a other.
\note The moved-from object \a other is placed in a
partially-formed state, in which the only valid operations are
destruction and assignment of a new value.
\since 6.4
*/
/*!
\fn QTemporaryDir &QTemporaryDir::operator=(QTemporaryDir&& other)
Move-assigns \a other to this QTemporaryDir instance.
\note The moved-from object \a other is placed in a
partially-formed state, in which the only valid operations are
destruction and assignment of a new value.
\since 6.4
*/
/*!
\fn void QTemporaryDir::swap(QTemporaryDir &other)
\memberswap{temporary-dir}
\since 6.4
*/
/*!
Destroys the temporary directory object.
If auto remove mode was set, it will automatically delete the directory
including all its contents.
\sa autoRemove()
*/
QTemporaryDir::~QTemporaryDir()
{
if (d_ptr) {
if (d_ptr->autoRemove)
remove();
delete d_ptr;
}
}
/*!
Returns \c true if the QTemporaryDir was created successfully.
*/
bool QTemporaryDir::isValid() const
{
return d_ptr->success;
}
/*!
\since 5.6
If isValid() returns \c false, this function returns the error string that
explains why the creation of the temporary directory failed. Otherwise, this
function return an empty string.
*/
QString QTemporaryDir::errorString() const
{
return d_ptr->success ? QString() : d_ptr->pathOrError;
}
/*!
Returns the path to the temporary directory.
Empty if the QTemporaryDir could not be created.
//! [relative-or-absolute-path]
The returned path will be relative or absolulte depending on whether
QTemporaryDir was constructed with a relative or absolute path,
respectively.
//! [relative-or-absolute-path]
*/
QString QTemporaryDir::path() const
{
return d_ptr->success ? d_ptr->pathOrError : QString();
}
/*!
\since 5.9
Returns the path name of a file in the temporary directory.
Does \e not check if the file actually exists in the directory.
Redundant multiple separators or "." and ".." directories in
\a fileName are not removed (see QDir::cleanPath()). Absolute
paths are not allowed.
\include qtemporarydir.cpp relative-or-absolute-path
*/
QString QTemporaryDir::filePath(const QString &fileName) const
{
if (QDir::isAbsolutePath(fileName)) {
qWarning("QTemporaryDir::filePath: Absolute paths are not allowed: %s", qUtf8Printable(fileName));
return QString();
}
if (!d_ptr->success)
return QString();
QString ret = d_ptr->pathOrError;
if (!fileName.isEmpty()) {
ret += u'/';
ret += fileName;
}
return ret;
}
/*!
Returns \c 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.
\sa setAutoRemove(), remove()
*/
bool QTemporaryDir::autoRemove() const
{
return d_ptr->autoRemove;
}
/*!
Sets the QTemporaryDir into auto-remove mode if \a b is true.
Auto-remove is on by default.
\sa autoRemove(), remove()
*/
void QTemporaryDir::setAutoRemove(bool b)
{
d_ptr->autoRemove = b;
}
/*!
Removes the temporary directory, including all its contents.
Returns \c true if removing was successful.
*/
bool QTemporaryDir::remove()
{
if (!d_ptr->success)
return false;
Q_ASSERT(!path().isEmpty());
Q_ASSERT(path() != "."_L1);
const bool result = QDir(path()).removeRecursively();
if (!result) {
qWarning() << "QTemporaryDir: Unable to remove"
<< QDir::toNativeSeparators(path())
<< "most likely due to the presence of read-only files.";
}
return result;
}
QT_END_NAMESPACE
#endif // QT_CONFIG(temporaryfile)