KisBackup Class Reference

#include <KisBackup.h>

Static Public Member Functions
static bool	backupFile (const QString &filename, const QString &backupDir=QString())
static bool	numberedBackupFile (const QString &filename, const QString &backupDir=QString(), const QString &backupExtension=QStringLiteral("~"), const uint maxBackups=10)
static bool	simpleBackupFile (const QString &filename, const QString &backupDir=QString(), const QString &backupExtension=QStringLiteral("~"))

Detailed Description

Definition at line 17 of file KisBackup.h.

Member Function Documentation

backupFile()

bool KisBackup::backupFile ( const QString & filename, const QString & backupDir = QString() )

static

Definition at line 19 of file KisBackup.cpp.

{
    return (simpleBackupFile(qFilename, backupDir, QStringLiteral("~")));
}

References simpleBackupFile().

numberedBackupFile()

bool KisBackup::numberedBackupFile ( const QString & filename, const QString & backupDir = QString(), const QString & backupExtension = QStringLiteral("~"), const uint maxBackups = 10 )

static

Definition at line 38 of file KisBackup.cpp.

{
    QFileInfo fileInfo(qFilename);
 
    // The backup file name template.
    QString sTemplate;
 
    if (backupDir.isEmpty()) {
        sTemplate = qFilename + QLatin1String(".%1") + backupExtension;
    } else {
        sTemplate = backupDir + QLatin1Char('/') + fileInfo.fileName() + QLatin1String(".%1") + backupExtension;
    }
    // First, search backupDir for numbered backup files to remove.
    // Remove all with number 'maxBackups' and greater.
    QDir d = backupDir.isEmpty() ? fileInfo.dir() : backupDir;
    d.setFilter(QDir::Files | QDir::Hidden | QDir::NoSymLinks);
 
    QString nameFilter = fileInfo.fileName() + QLatin1String(".*") + backupExtension;
    nameFilter.replace('[', '*');
    nameFilter.replace(']', '*');
 
    const QStringList nameFilters = QStringList(nameFilter);
    d.setNameFilters(nameFilters);
    d.setSorting(QDir::Name);
 
    uint maxBackupFound = 0;
    const QFileInfoList infoList = d.entryInfoList();
    for (const QFileInfo &fi : infoList) {
        if (fi.fileName().endsWith(backupExtension)) {
            // sTemp holds the file name, without the ending backupExtension
            QString sTemp = fi.fileName();
 
            sTemp.truncate(fi.fileName().length() - backupExtension.length());
 
            // compute the backup number
            int idex = sTemp.lastIndexOf(QLatin1Char('.'));
            if (idex > 0) {
                bool ok;
#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
                const uint num = QStringView(sTemp).mid(idex + 1).toUInt(&ok);
#else
                const uint num = sTemp.midRef(idex + 1).toUInt(&ok);
#endif
                if (ok) {
                    if (num >= maxBackups) {
                        QFile::remove(fi.filePath());
                    } else {
                        maxBackupFound = qMax(maxBackupFound, num);
                    }
                }
            }
        }
    }
 
    // Next, rename max-1 to max, max-2 to max-1, etc.
    QString to = sTemplate.arg(maxBackupFound + 1);
 
    for (int i = maxBackupFound; i > 0; i--) {
        QString from = sTemplate.arg(i);
        //        qCDebug(KCOREADDONS_DEBUG) << "KisBackup renaming " << from << " to " << to;
        QFile::rename(from, to);
        to = from;
    }
 
    // Finally create most recent backup by copying the file to backup number 1.
    //    qCDebug(KCOREADDONS_DEBUG) << "KisBackup copying " << qFilename << " to " << sTemplate.arg(1);
    bool r = QFile::copy(qFilename, sTemplate.arg(1));
    return r;
}

simpleBackupFile()

bool KisBackup::simpleBackupFile ( const QString & filename, const QString & backupDir = QString(), const QString & backupExtension = QStringLiteral("~") )

static

Definition at line 24 of file KisBackup.cpp.

{
    QString backupFileName = qFilename + backupExtension;
 
    if (!backupDir.isEmpty()) {
        QFileInfo fileInfo(qFilename);
        backupFileName = backupDir + QLatin1Char('/') + fileInfo.fileName() + backupExtension;
    }
 
    //    qCDebug(KCOREADDONS_DEBUG) << "KisBackup copying " << qFilename << " to " << backupFileName;
    QFile::remove(backupFileName);
    return QFile::copy(qFilename, backupFileName);
}

---

The documentation for this class was generated from the following files:

• libs/global/KisBackup.h
• libs/global/KisBackup.cpp