Method BackupFile

src/util/fileutil.cpp:191–238

////////////////////////////////////////////////////////////////////////// BackupFile Renames the file, if it exists, to an appropiate backup name for the OS. Prints warning and returns false if file backup fails, otherwise returns true. An eFile(ERR_FILE_WRITE_FAILED) will be thrown if the file is not writable. This is because we don't want to overwrite read-only files, which would happen if we

// if we were just renamed the file to a backup filename.
///////////////////////////////////////////////////////////////////////////////
bool cFileUtil::BackupFile(const TSTRING& filename, bool printWarningOnFailure) // throw eFile()
{
    // if the file does not exist, no worries
    if (!cFileUtil::FileExists(filename))
        return true;

    // if the file is not a regular file, it is not appropriate to back it up
    if (!cFileUtil::IsRegularFile(filename))
        return true;

    // if it is not writeable, throw error
    if (!cFileUtil::FileWritable(filename))
    {
        // if this assert goes off, you didn't check that the file was writeable
        // before calling BackupFile().
        ASSERT(false);
        throw eFileWrite(filename, iFSServices::GetInstance()->GetErrString());
    }

#if IS_DOS_DJGPP
    TSTRING backup_filename = cDosPath::BackupName(cDosPath::AsNative(filename));
#else
    TSTRING backup_filename = filename;
#endif

    backup_filename += iFSServices::GetInstance()->GetStandardBackupExtension();

    // remove the backup file if it exists.  We ingore the return value from
    // _tunlink(), problems removing the file will be caught by _trename().
    _tunlink(backup_filename.c_str());

    // back up the file, preserving permissions and ownership, if possible
    if (cFileUtil::Copy(filename.c_str(), backup_filename.c_str()) == false)
    {
        if (printWarningOnFailure && iUserNotify::GetInstance()->GetVerboseLevel() >= iUserNotify::V_NORMAL)
        {
            TSTRING estr;
            estr.assign(TSS_GetString(cUtil, util::STR_ERR2_BACKUP_FAILED1));
            estr.append(filename);
            estr.append(TSS_GetString(cUtil, util::STR_ERR2_BACKUP_FAILED2));
            estr.append(backup_filename);
            estr.append(TSS_GetString(cUtil, util::STR_ERR2_BACKUP_FAILED3));

            cErrorReporter::PrintErrorMsg(eFileUtilBackup(estr, eError::NON_FATAL | eError::SUPRESS_THIRD_MSG));
        }
    }
    return true;
}

bool cFileUtil::Copy(const TSTRING& src_path, const TSTRING& dest_path)
{