Класс QTemporaryDir

Класс QTemporaryDir создаёт уникальную директорию для временного использования. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются перевходными.

Публичные функции

Подробное описание

Класс QTemporaryDir создаёт уникальную директорию для временного использования.

QTemporaryDir используется для безопасного создания уникальных временных директорий. Директория создаётся в конструкторе. Имя временной директории гарантированно уникально (т.е., вы гарантированно не перезапишете существующую директорию), и директория будет удалена при уничтожении объекта QTemporaryDir. Имя директории генерируется автоматически или создаётся на основе шаблона, передаваемого в конструктор QTemporaryDir.

Пример:

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

Очень важно проверить, что временная директория была создана, используя isValid(). Не используйте exists(), так как QDir по умолчанию представляет текущую директорию, которая существует.

Путь к временной директории можно получить, вызвав path().

Временная директория будет иметь статическую часть имени и часть, которая рассчитывается для уникальности. Путь по умолчанию будет определён из QCoreApplication::applicationName() (в противном случае qt_temp) и помещён во временный путь, возвращаемый QDir::tempPath(). Если вы укажете свой собственный путь, относительный путь по умолчанию не будет помещён во временную директорию, а будет относительным к текущей рабочей директории. Во всех случаях к пути будет добавлен случайный строковый код для его уникальности.

См. также QDir::tempPath(), QDir и QTemporaryFile.

Документация по функциям-членам

QTemporaryDir::QTemporaryDir()

Конструирует QTemporaryDir с использованием шаблона имени приложения, возвращаемого QCoreApplication::applicationName() (в противном случае qt_temp). Директория сохраняется во временной директории системы, QDir::tempPath().

См. также QDir::tempPath().

QTemporaryDir::QTemporaryDir(const QString &templatePath)

Конструирует QTemporaryDir с шаблоном templatePath.

Если templatePath — относительный путь, то путь будет относительным к текущей рабочей директории. Вы можете использовать QDir::tempPath() для создания templatePath, если хотите использовать временную директорию системы.

Если templatePath заканчивается на XXXXXX, он будет использован как динамическая часть имени директории, иначе будет добавлен. В отличие от QTemporaryFile, XXXXXX в середине шаблона строки не поддерживается.

См. также QDir::tempPath().

QTemporaryDir::~QTemporaryDir()

Уничтожает объект временной директории. Если режим автоматического удаления был установлен, он автоматически удалит директорию вместе со всем её содержимым.

См. также autoRemove().

bool QTemporaryDir::autoRemove() const

Возвращает true если QTemporaryDir находится в режиме автоматического удаления. Режим автоматического удаления автоматически удалит директорию с диска при уничтожении. Это очень упрощает создание объекта QTemporaryDir в стеке, заполнение его файлами, выполнение операций с файлами, и в итоге при возврате из функции он автоматически очистит за собой.

Автоудаление включено по умолчанию.

См. также setAutoRemove() и remove().

QString QTemporaryDir::errorString() const

Если isValid() возвращает false, эта функция возвращает строку ошибки, объясняющую, почему создание временной директории завершилось неудачей. В противном случае эта функция возвращает пустую строку.

Эта функция была введена в Qt 5.6.

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

Возвращает имя пути файла во временной директории. Не проверяет, существует ли файл в директории. Избыточные последовательные разделители или каталоги "." и ".." в fileName не удаляются (см. QDir::cleanPath()). Абсолютные пути не допускаются.

Эта функция была введена в Qt 5.9.

bool QTemporaryDir::isValid() const

Возвращает true если QTemporaryDir был успешно создан.

QString QTemporaryDir::path() const

Возвращает путь к временной директории. Пустая строка, если QTemporaryDir не удалось создать.

bool QTemporaryDir::remove()

Удаляет временную директорию, включая всё её содержимое.

Возвращает true если удаление прошло успешно.

void QTemporaryDir::setAutoRemove(bool b)

Устанавливает QTemporaryDir в режим автоматического удаления, если b равно true.

Автоудаление включено по умолчанию.

См. также autoRemove() и remove().