citra/src/common/file_util.cpp

870 lines
26 KiB
C++
Raw Normal View History

2014-12-17 05:38:14 +00:00
// Copyright 2013 Dolphin Emulator Project / 2014 Citra Emulator Project
// Licensed under GPLv2 or any later version
// Refer to the license.txt file included.
#include <array>
#include <memory>
#include <unordered_map>
2015-05-06 07:06:12 +00:00
#include "common/assert.h"
#include "common/common_funcs.h"
#include "common/common_paths.h"
#include "common/file_util.h"
2015-05-06 07:06:12 +00:00
#include "common/logging/log.h"
#ifdef _WIN32
#include <windows.h>
// windows.h needs to be included before other windows headers
#include <direct.h> // getcwd
#include <io.h>
#include <shellapi.h>
#include <shlobj.h> // for SHGetFolderPath
#include <tchar.h>
#include "common/string_util.h"
#ifdef _MSC_VER
// 64 bit offsets for MSVC
#define fseeko _fseeki64
#define ftello _ftelli64
#define fileno _fileno
#endif
// 64 bit offsets for MSVC and MinGW. MinGW also needs this for using _wstat64
#define stat _stat64
#define fstat _fstat64
#else
#ifdef __APPLE__
#include <sys/param.h>
#endif
#include <cctype>
#include <cerrno>
#include <cstdlib>
#include <cstring>
#include <dirent.h>
#include <pwd.h>
#include <unistd.h>
#endif
#if defined(__APPLE__)
2016-12-13 17:58:50 +00:00
// CFURL contains __attribute__ directives that gcc does not know how to parse, so we need to just
// ignore them if we're not using clang. The macro is only used to prevent linking against
// functions that don't exist on older versions of macOS, and the worst case scenario is a linker
// error, so this is perfectly safe, just inconvenient.
#ifndef __clang__
#define availability(...)
#endif
#include <CoreFoundation/CFBundle.h>
#include <CoreFoundation/CFString.h>
#include <CoreFoundation/CFURL.h>
2016-12-13 17:58:50 +00:00
#ifdef availability
#undef availability
#endif
#endif
#include <algorithm>
#include <sys/stat.h>
#ifndef S_ISDIR
#define S_ISDIR(m) (((m)&S_IFMT) == S_IFDIR)
#endif
// This namespace has various generic functions related to files and paths.
// The code still needs a ton of cleanup.
// REMEMBER: strdup considered harmful!
namespace FileUtil {
// Remove any ending forward slashes from directory paths
// Modifies argument.
static void StripTailDirSlashes(std::string& fname) {
Port yuzu-emu/yuzu#2511: "common/file_util: Minor cleanup" (#4782) * common/file_util: Make IOFile's WriteString take a std::string_view We don't need to force the usage of a std::string here, and can instead use a std::string_view, which allows writing out other forms of strings (e.g. C-style strings) without any unnecessary heap allocations. * common/file_util: Remove unnecessary c_str() calls The file stream open functions have supported std::string overloads since C++11, so we don't need to use c_str() here. Same behavior, less code. * common/file_util: Make ReadFileToString and WriteStringToFile consistent Makes the parameter ordering consistent, and also makes the filename parameter a std::string. A std::string would be constructed anyways with the previous code, as IOFile's only constructor with a filepath is one taking a std::string. We can also make WriteStringToFile's string parameter utilize a std::string_view for the string, making use of our previous changes to IOFile. * common/file_util: Remove duplicated documentation comments These are already present within the header, so they don't need to be repeated in the cpp file. * common/file_util: Make GetCurrentDir() return a std::optional nullptr was being returned in the error case, which, at a glance may seem perfectly OK... until you realize that std::string has the invariant that it may not be constructed from a null pointer. This means that if this error case was ever hit, then the application would most likely crash from a thrown exception in std::string's constructor. Instead, we can change the function to return an optional value, indicating if a failure occurred. * common/file_util: Remove unnecessary return at end of void StripTailDirSlashes() While we're at it, also invert the conditional into a guard clause.
2019-06-07 22:23:57 +00:00
if (fname.length() <= 1) {
return;
}
std::size_t i = fname.length();
while (i > 0 && fname[i - 1] == DIR_SEP_CHR) {
--i;
2014-04-01 22:20:08 +00:00
}
Port yuzu-emu/yuzu#2511: "common/file_util: Minor cleanup" (#4782) * common/file_util: Make IOFile's WriteString take a std::string_view We don't need to force the usage of a std::string here, and can instead use a std::string_view, which allows writing out other forms of strings (e.g. C-style strings) without any unnecessary heap allocations. * common/file_util: Remove unnecessary c_str() calls The file stream open functions have supported std::string overloads since C++11, so we don't need to use c_str() here. Same behavior, less code. * common/file_util: Make ReadFileToString and WriteStringToFile consistent Makes the parameter ordering consistent, and also makes the filename parameter a std::string. A std::string would be constructed anyways with the previous code, as IOFile's only constructor with a filepath is one taking a std::string. We can also make WriteStringToFile's string parameter utilize a std::string_view for the string, making use of our previous changes to IOFile. * common/file_util: Remove duplicated documentation comments These are already present within the header, so they don't need to be repeated in the cpp file. * common/file_util: Make GetCurrentDir() return a std::optional nullptr was being returned in the error case, which, at a glance may seem perfectly OK... until you realize that std::string has the invariant that it may not be constructed from a null pointer. This means that if this error case was ever hit, then the application would most likely crash from a thrown exception in std::string's constructor. Instead, we can change the function to return an optional value, indicating if a failure occurred. * common/file_util: Remove unnecessary return at end of void StripTailDirSlashes() While we're at it, also invert the conditional into a guard clause.
2019-06-07 22:23:57 +00:00
fname.resize(i);
}
bool Exists(const std::string& filename) {
struct stat file_info;
2014-04-01 22:20:08 +00:00
std::string copy(filename);
StripTailDirSlashes(copy);
#ifdef _WIN32
// Windows needs a slash to identify a driver root
if (copy.size() != 0 && copy.back() == ':')
copy += DIR_SEP_CHR;
2016-03-31 10:58:37 +00:00
int result = _wstat64(Common::UTF8ToUTF16W(copy).c_str(), &file_info);
#else
int result = stat(copy.c_str(), &file_info);
#endif
2014-04-01 22:20:08 +00:00
return (result == 0);
}
bool IsDirectory(const std::string& filename) {
struct stat file_info;
2014-04-01 22:20:08 +00:00
std::string copy(filename);
StripTailDirSlashes(copy);
#ifdef _WIN32
// Windows needs a slash to identify a driver root
if (copy.size() != 0 && copy.back() == ':')
copy += DIR_SEP_CHR;
2016-03-31 10:58:37 +00:00
int result = _wstat64(Common::UTF8ToUTF16W(copy).c_str(), &file_info);
#else
int result = stat(copy.c_str(), &file_info);
#endif
2014-04-01 22:20:08 +00:00
if (result < 0) {
2018-06-29 11:18:07 +00:00
LOG_DEBUG(Common_Filesystem, "stat failed on {}: {}", filename, GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return false;
}
2014-04-01 22:20:08 +00:00
return S_ISDIR(file_info.st_mode);
}
bool Delete(const std::string& filename) {
2018-06-29 11:18:07 +00:00
LOG_TRACE(Common_Filesystem, "file {}", filename);
// Return true because we care about the file no
2014-04-01 22:20:08 +00:00
// being there, not the actual delete.
if (!Exists(filename)) {
2018-06-29 11:18:07 +00:00
LOG_DEBUG(Common_Filesystem, "{} does not exist", filename);
2014-04-01 22:20:08 +00:00
return true;
}
2014-04-01 22:20:08 +00:00
// We can't delete a directory
if (IsDirectory(filename)) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "Failed: {} is a directory", filename);
2014-04-01 22:20:08 +00:00
return false;
}
#ifdef _WIN32
if (!DeleteFileW(Common::UTF8ToUTF16W(filename).c_str())) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "DeleteFile failed on {}: {}", filename, GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return false;
}
#else
2014-04-01 22:20:08 +00:00
if (unlink(filename.c_str()) == -1) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "unlink failed on {}: {}", filename, GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return false;
}
#endif
2014-04-01 22:20:08 +00:00
return true;
}
bool CreateDir(const std::string& path) {
2018-06-29 11:18:07 +00:00
LOG_TRACE(Common_Filesystem, "directory {}", path);
#ifdef _WIN32
2016-03-31 10:58:37 +00:00
if (::CreateDirectoryW(Common::UTF8ToUTF16W(path).c_str(), nullptr))
2014-04-01 22:20:08 +00:00
return true;
DWORD error = GetLastError();
if (error == ERROR_ALREADY_EXISTS) {
2018-06-29 11:18:07 +00:00
LOG_DEBUG(Common_Filesystem, "CreateDirectory failed on {}: already exists", path);
2014-04-01 22:20:08 +00:00
return true;
}
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "CreateDirectory failed on {}: {}", path, error);
2014-04-01 22:20:08 +00:00
return false;
#else
2014-04-01 22:20:08 +00:00
if (mkdir(path.c_str(), 0755) == 0)
return true;
2014-04-01 22:20:08 +00:00
int err = errno;
if (err == EEXIST) {
2018-06-29 11:18:07 +00:00
LOG_DEBUG(Common_Filesystem, "mkdir failed on {}: already exists", path);
2014-04-01 22:20:08 +00:00
return true;
}
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "mkdir failed on {}: {}", path, strerror(err));
2014-04-01 22:20:08 +00:00
return false;
#endif
}
bool CreateFullPath(const std::string& fullPath) {
2014-04-01 22:20:08 +00:00
int panicCounter = 100;
2018-06-29 11:18:07 +00:00
LOG_TRACE(Common_Filesystem, "path {}", fullPath);
2016-03-31 12:29:39 +00:00
if (FileUtil::Exists(fullPath)) {
2018-06-29 11:18:07 +00:00
LOG_DEBUG(Common_Filesystem, "path exists {}", fullPath);
2014-04-01 22:20:08 +00:00
return true;
}
std::size_t position = 0;
while (true) {
2014-04-01 22:20:08 +00:00
// Find next sub path
position = fullPath.find(DIR_SEP_CHR, position);
2014-04-01 22:20:08 +00:00
// we're done, yay!
if (position == fullPath.npos)
return true;
2014-04-01 22:20:08 +00:00
// Include the '/' so the first call is CreateDir("/") rather than CreateDir("")
std::string const subPath(fullPath.substr(0, position + 1));
if (!FileUtil::IsDirectory(subPath) && !FileUtil::CreateDir(subPath)) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common, "CreateFullPath: directory creation failed");
return false;
}
2014-04-01 22:20:08 +00:00
// A safety check
panicCounter--;
if (panicCounter <= 0) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common, "CreateFullPath: directory structure is too deep");
2014-04-01 22:20:08 +00:00
return false;
}
position++;
}
}
bool DeleteDir(const std::string& filename) {
2018-06-29 11:18:07 +00:00
LOG_TRACE(Common_Filesystem, "directory {}", filename);
2014-04-01 22:20:08 +00:00
// check if a directory
if (!FileUtil::IsDirectory(filename)) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "Not a directory {}", filename);
2014-04-01 22:20:08 +00:00
return false;
}
#ifdef _WIN32
2016-03-31 10:58:37 +00:00
if (::RemoveDirectoryW(Common::UTF8ToUTF16W(filename).c_str()))
2014-04-01 22:20:08 +00:00
return true;
#else
2014-04-01 22:20:08 +00:00
if (rmdir(filename.c_str()) == 0)
return true;
#endif
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "failed {}: {}", filename, GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return false;
}
bool Rename(const std::string& srcFilename, const std::string& destFilename) {
2018-06-29 11:18:07 +00:00
LOG_TRACE(Common_Filesystem, "{} --> {}", srcFilename, destFilename);
2016-03-31 10:58:37 +00:00
#ifdef _WIN32
if (_wrename(Common::UTF8ToUTF16W(srcFilename).c_str(),
Common::UTF8ToUTF16W(destFilename).c_str()) == 0)
2016-03-31 10:58:37 +00:00
return true;
#else
2014-04-01 22:20:08 +00:00
if (rename(srcFilename.c_str(), destFilename.c_str()) == 0)
return true;
2016-03-31 10:58:37 +00:00
#endif
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "failed {} --> {}: {}", srcFilename, destFilename,
2018-06-29 13:56:12 +00:00
GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return false;
}
bool Copy(const std::string& srcFilename, const std::string& destFilename) {
2018-06-29 11:18:07 +00:00
LOG_TRACE(Common_Filesystem, "{} --> {}", srcFilename, destFilename);
#ifdef _WIN32
if (CopyFileW(Common::UTF8ToUTF16W(srcFilename).c_str(),
Common::UTF8ToUTF16W(destFilename).c_str(), FALSE))
2014-04-01 22:20:08 +00:00
return true;
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "failed {} --> {}: {}", srcFilename, destFilename,
2018-06-29 13:56:12 +00:00
GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return false;
#else
using CFilePointer = std::unique_ptr<FILE, decltype(&std::fclose)>;
2014-04-01 22:20:08 +00:00
// Open input file
CFilePointer input{fopen(srcFilename.c_str(), "rb"), std::fclose};
if (!input) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "opening input failed {} --> {}: {}", srcFilename,
2018-06-29 13:56:12 +00:00
destFilename, GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return false;
}
// open output file
CFilePointer output{fopen(destFilename.c_str(), "wb"), std::fclose};
if (!output) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "opening output failed {} --> {}: {}", srcFilename,
2018-06-29 13:56:12 +00:00
destFilename, GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return false;
}
// copy loop
std::array<char, 1024> buffer;
while (!feof(input.get())) {
2014-04-01 22:20:08 +00:00
// read input
std::size_t rnum = fread(buffer.data(), sizeof(char), buffer.size(), input.get());
if (rnum != buffer.size()) {
if (ferror(input.get()) != 0) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "failed reading from source, {} --> {}: {}",
2018-06-29 13:56:12 +00:00
srcFilename, destFilename, GetLastErrorMsg());
return false;
2014-04-01 22:20:08 +00:00
}
}
// write output
std::size_t wnum = fwrite(buffer.data(), sizeof(char), rnum, output.get());
if (wnum != rnum) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "failed writing to output, {} --> {}: {}", srcFilename,
2018-06-29 13:56:12 +00:00
destFilename, GetLastErrorMsg());
return false;
2014-04-01 22:20:08 +00:00
}
}
2014-04-01 22:20:08 +00:00
return true;
#endif
}
u64 GetSize(const std::string& filename) {
if (!Exists(filename)) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "failed {}: No such file", filename);
2014-04-01 22:20:08 +00:00
return 0;
}
if (IsDirectory(filename)) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "failed {}: is a directory", filename);
2014-04-01 22:20:08 +00:00
return 0;
}
struct stat buf;
#ifdef _WIN32
2016-03-31 10:58:37 +00:00
if (_wstat64(Common::UTF8ToUTF16W(filename).c_str(), &buf) == 0)
#else
if (stat(filename.c_str(), &buf) == 0)
#endif
2014-04-01 22:20:08 +00:00
{
2018-06-29 11:18:07 +00:00
LOG_TRACE(Common_Filesystem, "{}: {}", filename, buf.st_size);
2014-04-01 22:20:08 +00:00
return buf.st_size;
}
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "Stat failed {}: {}", filename, GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return 0;
}
u64 GetSize(const int fd) {
struct stat buf;
if (fstat(fd, &buf) != 0) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "GetSize: stat failed {}: {}", fd, GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return 0;
}
return buf.st_size;
}
u64 GetSize(FILE* f) {
2014-04-01 22:20:08 +00:00
// can't use off_t here because it can be 32-bit
u64 pos = ftello(f);
if (fseeko(f, 0, SEEK_END) != 0) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "GetSize: seek failed {}: {}", (void*)f, GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return 0;
}
u64 size = ftello(f);
if ((size != pos) && (fseeko(f, pos, SEEK_SET) != 0)) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "GetSize: seek failed {}: {}", (void*)f, GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return 0;
}
return size;
}
bool CreateEmptyFile(const std::string& filename) {
2018-06-29 11:18:07 +00:00
LOG_TRACE(Common_Filesystem, "{}", filename);
if (!FileUtil::IOFile(filename, "wb")) {
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "failed {}: {}", filename, GetLastErrorMsg());
2014-04-01 22:20:08 +00:00
return false;
}
2014-04-01 22:20:08 +00:00
return true;
}
bool ForeachDirectoryEntry(u64* num_entries_out, const std::string& directory,
DirectoryEntryCallable callback) {
2018-06-29 11:18:07 +00:00
LOG_TRACE(Common_Filesystem, "directory {}", directory);
2014-04-01 22:20:08 +00:00
// How many files + directories we found
u64 found_entries = 0;
// Save the status of callback function
bool callback_error = false;
#ifdef _WIN32
2014-04-01 22:20:08 +00:00
// Find the first file in the directory.
2016-03-31 10:58:37 +00:00
WIN32_FIND_DATAW ffd;
2014-04-01 22:20:08 +00:00
2016-03-31 10:58:37 +00:00
HANDLE handle_find = FindFirstFileW(Common::UTF8ToUTF16W(directory + "\\*").c_str(), &ffd);
if (handle_find == INVALID_HANDLE_VALUE) {
FindClose(handle_find);
return false;
2014-04-01 22:20:08 +00:00
}
// windows loop
do {
2016-03-31 10:58:37 +00:00
const std::string virtual_name(Common::UTF16ToUTF8(ffd.cFileName));
#else
DIR* dirp = opendir(directory.c_str());
2014-04-01 22:20:08 +00:00
if (!dirp)
return false;
2014-04-01 22:20:08 +00:00
// non windows loop
while (struct dirent* result = readdir(dirp)) {
const std::string virtual_name(result->d_name);
#endif
if (virtual_name == "." || virtual_name == "..")
2014-04-01 22:20:08 +00:00
continue;
u64 ret_entries = 0;
if (!callback(&ret_entries, directory, virtual_name)) {
callback_error = true;
break;
}
found_entries += ret_entries;
#ifdef _WIN32
2016-03-31 10:58:37 +00:00
} while (FindNextFileW(handle_find, &ffd) != 0);
FindClose(handle_find);
#else
2014-04-01 22:20:08 +00:00
}
closedir(dirp);
#endif
if (callback_error)
return false;
// num_entries_out is allowed to be specified nullptr, in which case we shouldn't try to set it
if (num_entries_out != nullptr)
*num_entries_out = found_entries;
return true;
}
u64 ScanDirectoryTree(const std::string& directory, FSTEntry& parent_entry,
unsigned int recursion) {
const auto callback = [recursion, &parent_entry](u64* num_entries_out,
const std::string& directory,
const std::string& virtual_name) -> bool {
FSTEntry entry;
entry.virtualName = virtual_name;
entry.physicalName = directory + DIR_SEP + virtual_name;
if (IsDirectory(entry.physicalName)) {
entry.isDirectory = true;
// is a directory, lets go inside if we didn't recurse to often
if (recursion > 0) {
entry.size = ScanDirectoryTree(entry.physicalName, entry, recursion - 1);
*num_entries_out += entry.size;
} else {
entry.size = 0;
}
} else { // is a file
entry.isDirectory = false;
entry.size = GetSize(entry.physicalName);
}
(*num_entries_out)++;
// Push into the tree
parent_entry.children.push_back(std::move(entry));
return true;
};
2014-04-01 22:20:08 +00:00
u64 num_entries;
return ForeachDirectoryEntry(&num_entries, directory, callback) ? num_entries : 0;
}
2014-04-01 22:20:08 +00:00
bool DeleteDirRecursively(const std::string& directory, unsigned int recursion) {
const auto callback = [recursion](u64* num_entries_out, const std::string& directory,
const std::string& virtual_name) -> bool {
std::string new_path = directory + DIR_SEP_CHR + virtual_name;
if (IsDirectory(new_path)) {
if (recursion == 0)
return false;
return DeleteDirRecursively(new_path, recursion - 1);
}
return Delete(new_path);
};
if (!ForeachDirectoryEntry(nullptr, directory, callback))
return false;
// Delete the outermost directory
FileUtil::DeleteDir(directory);
2014-04-01 22:20:08 +00:00
return true;
}
void CopyDir(const std::string& source_path, const std::string& dest_path) {
#ifndef _WIN32
if (source_path == dest_path)
return;
if (!FileUtil::Exists(source_path))
return;
if (!FileUtil::Exists(dest_path))
FileUtil::CreateFullPath(dest_path);
DIR* dirp = opendir(source_path.c_str());
if (!dirp)
return;
2014-04-01 22:20:08 +00:00
while (struct dirent* result = readdir(dirp)) {
2014-04-01 22:20:08 +00:00
const std::string virtualName(result->d_name);
// check for "." and ".."
if (((virtualName[0] == '.') && (virtualName[1] == '\0')) ||
((virtualName[0] == '.') && (virtualName[1] == '.') && (virtualName[2] == '\0')))
2014-04-01 22:20:08 +00:00
continue;
std::string source, dest;
source = source_path + virtualName;
dest = dest_path + virtualName;
if (IsDirectory(source)) {
2014-04-01 22:20:08 +00:00
source += '/';
dest += '/';
if (!FileUtil::Exists(dest))
FileUtil::CreateFullPath(dest);
2014-04-01 22:20:08 +00:00
CopyDir(source, dest);
} else if (!FileUtil::Exists(dest))
FileUtil::Copy(source, dest);
2014-04-01 22:20:08 +00:00
}
closedir(dirp);
#endif
}
Port yuzu-emu/yuzu#2511: "common/file_util: Minor cleanup" (#4782) * common/file_util: Make IOFile's WriteString take a std::string_view We don't need to force the usage of a std::string here, and can instead use a std::string_view, which allows writing out other forms of strings (e.g. C-style strings) without any unnecessary heap allocations. * common/file_util: Remove unnecessary c_str() calls The file stream open functions have supported std::string overloads since C++11, so we don't need to use c_str() here. Same behavior, less code. * common/file_util: Make ReadFileToString and WriteStringToFile consistent Makes the parameter ordering consistent, and also makes the filename parameter a std::string. A std::string would be constructed anyways with the previous code, as IOFile's only constructor with a filepath is one taking a std::string. We can also make WriteStringToFile's string parameter utilize a std::string_view for the string, making use of our previous changes to IOFile. * common/file_util: Remove duplicated documentation comments These are already present within the header, so they don't need to be repeated in the cpp file. * common/file_util: Make GetCurrentDir() return a std::optional nullptr was being returned in the error case, which, at a glance may seem perfectly OK... until you realize that std::string has the invariant that it may not be constructed from a null pointer. This means that if this error case was ever hit, then the application would most likely crash from a thrown exception in std::string's constructor. Instead, we can change the function to return an optional value, indicating if a failure occurred. * common/file_util: Remove unnecessary return at end of void StripTailDirSlashes() While we're at it, also invert the conditional into a guard clause.
2019-06-07 22:23:57 +00:00
std::optional<std::string> GetCurrentDir() {
// Get the current working directory (getcwd uses malloc)
2016-03-31 11:21:03 +00:00
#ifdef _WIN32
wchar_t* dir;
2019-03-10 01:15:35 +00:00
if (!(dir = _wgetcwd(nullptr, 0)))
2016-03-31 11:21:03 +00:00
#else
char* dir;
2019-03-10 01:15:35 +00:00
if (!(dir = getcwd(nullptr, 0)))
2016-03-31 11:21:03 +00:00
#endif
2019-03-10 01:15:35 +00:00
{
2018-06-29 11:18:07 +00:00
LOG_ERROR(Common_Filesystem, "GetCurrentDirectory failed: {}", GetLastErrorMsg());
Port yuzu-emu/yuzu#2511: "common/file_util: Minor cleanup" (#4782) * common/file_util: Make IOFile's WriteString take a std::string_view We don't need to force the usage of a std::string here, and can instead use a std::string_view, which allows writing out other forms of strings (e.g. C-style strings) without any unnecessary heap allocations. * common/file_util: Remove unnecessary c_str() calls The file stream open functions have supported std::string overloads since C++11, so we don't need to use c_str() here. Same behavior, less code. * common/file_util: Make ReadFileToString and WriteStringToFile consistent Makes the parameter ordering consistent, and also makes the filename parameter a std::string. A std::string would be constructed anyways with the previous code, as IOFile's only constructor with a filepath is one taking a std::string. We can also make WriteStringToFile's string parameter utilize a std::string_view for the string, making use of our previous changes to IOFile. * common/file_util: Remove duplicated documentation comments These are already present within the header, so they don't need to be repeated in the cpp file. * common/file_util: Make GetCurrentDir() return a std::optional nullptr was being returned in the error case, which, at a glance may seem perfectly OK... until you realize that std::string has the invariant that it may not be constructed from a null pointer. This means that if this error case was ever hit, then the application would most likely crash from a thrown exception in std::string's constructor. Instead, we can change the function to return an optional value, indicating if a failure occurred. * common/file_util: Remove unnecessary return at end of void StripTailDirSlashes() While we're at it, also invert the conditional into a guard clause.
2019-06-07 22:23:57 +00:00
return {};
2014-04-01 22:20:08 +00:00
}
2016-03-31 11:21:03 +00:00
#ifdef _WIN32
std::string strDir = Common::UTF16ToUTF8(dir);
#else
2014-04-01 22:20:08 +00:00
std::string strDir = dir;
2016-03-31 11:21:03 +00:00
#endif
2014-04-01 22:20:08 +00:00
free(dir);
return strDir;
}
bool SetCurrentDir(const std::string& directory) {
2016-03-31 11:21:03 +00:00
#ifdef _WIN32
return _wchdir(Common::UTF8ToUTF16W(directory).c_str()) == 0;
#else
return chdir(directory.c_str()) == 0;
2016-03-31 11:21:03 +00:00
#endif
}
#if defined(__APPLE__)
std::string GetBundleDirectory() {
2014-04-01 22:20:08 +00:00
CFURLRef BundleRef;
char AppBundlePath[MAXPATHLEN];
// Get the main bundle for the app
BundleRef = CFBundleCopyBundleURL(CFBundleGetMainBundle());
CFStringRef BundlePath = CFURLCopyFileSystemPath(BundleRef, kCFURLPOSIXPathStyle);
CFStringGetFileSystemRepresentation(BundlePath, AppBundlePath, sizeof(AppBundlePath));
CFRelease(BundleRef);
CFRelease(BundlePath);
2014-04-01 22:20:08 +00:00
return AppBundlePath;
}
#endif
#ifdef _WIN32
const std::string& GetExeDirectory() {
static std::string exe_path;
if (exe_path.empty()) {
2016-03-31 11:21:03 +00:00
wchar_t wchar_exe_path[2048];
GetModuleFileNameW(nullptr, wchar_exe_path, 2048);
exe_path = Common::UTF16ToUTF8(wchar_exe_path);
exe_path = exe_path.substr(0, exe_path.find_last_of('\\'));
2014-04-01 22:20:08 +00:00
}
return exe_path;
}
2016-11-24 15:42:31 +00:00
std::string AppDataRoamingDirectory() {
2016-11-17 11:29:57 +00:00
PWSTR pw_local_path = nullptr;
// Only supported by Windows Vista or later
2016-11-24 15:42:31 +00:00
SHGetKnownFolderPath(FOLDERID_RoamingAppData, 0, nullptr, &pw_local_path);
2016-11-17 11:29:57 +00:00
std::string local_path = Common::UTF16ToUTF8(pw_local_path);
CoTaskMemFree(pw_local_path);
return local_path;
}
#else
/**
* @return The users home directory on POSIX systems
*/
static const std::string& GetHomeDirectory() {
static std::string home_path;
if (home_path.empty()) {
const char* envvar = getenv("HOME");
if (envvar) {
home_path = envvar;
} else {
auto pw = getpwuid(getuid());
ASSERT_MSG(pw,
"$HOME isnt defined, and the current user cant be found in /etc/passwd.");
home_path = pw->pw_dir;
}
}
return home_path;
}
/**
* Follows the XDG Base Directory Specification to get a directory path
* @param envvar The XDG environment variable to get the value from
* @return The directory path
* @sa http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html
*/
static const std::string GetUserDirectory(const std::string& envvar) {
const char* directory = getenv(envvar.c_str());
std::string user_dir;
if (directory) {
user_dir = directory;
} else {
std::string subdirectory;
if (envvar == "XDG_DATA_HOME")
subdirectory = DIR_SEP ".local" DIR_SEP "share";
else if (envvar == "XDG_CONFIG_HOME")
subdirectory = DIR_SEP ".config";
else if (envvar == "XDG_CACHE_HOME")
subdirectory = DIR_SEP ".cache";
else
ASSERT_MSG(false, "Unknown XDG variable {}.", envvar);
user_dir = GetHomeDirectory() + subdirectory;
}
ASSERT_MSG(!user_dir.empty(), "User directory {} musnt be empty.", envvar);
ASSERT_MSG(user_dir[0] == '/', "User directory {} must be absolute.", envvar);
return user_dir;
}
#endif
std::string GetSysDirectory() {
2014-04-01 22:20:08 +00:00
std::string sysDir;
#if defined(__APPLE__)
2014-04-01 22:20:08 +00:00
sysDir = GetBundleDirectory();
sysDir += DIR_SEP;
sysDir += SYSDATA_DIR;
#else
2014-04-01 22:20:08 +00:00
sysDir = SYSDATA_DIR;
#endif
2014-04-01 22:20:08 +00:00
sysDir += DIR_SEP;
2018-06-29 11:18:07 +00:00
LOG_DEBUG(Common_Filesystem, "Setting to {}:", sysDir);
2014-04-01 22:20:08 +00:00
return sysDir;
}
namespace {
std::unordered_map<UserPath, std::string> g_paths;
}
void SetUserPath(const std::string& path) {
std::string& user_path = g_paths[UserPath::UserDir];
if (!path.empty() && CreateFullPath(path)) {
LOG_INFO(Common_Filesystem, "Using {} as the user directory", path);
user_path = path;
g_paths.emplace(UserPath::ConfigDir, user_path + CONFIG_DIR DIR_SEP);
g_paths.emplace(UserPath::CacheDir, user_path + CACHE_DIR DIR_SEP);
} else {
#ifdef _WIN32
user_path = GetExeDirectory() + DIR_SEP USERDATA_DIR DIR_SEP;
if (!FileUtil::IsDirectory(user_path)) {
user_path = AppDataRoamingDirectory() + DIR_SEP EMU_DATA_DIR DIR_SEP;
} else {
2018-06-29 11:18:07 +00:00
LOG_INFO(Common_Filesystem, "Using the local user directory");
}
g_paths.emplace(UserPath::ConfigDir, user_path + CONFIG_DIR DIR_SEP);
g_paths.emplace(UserPath::CacheDir, user_path + CACHE_DIR DIR_SEP);
2019-01-16 01:12:43 +00:00
#elif ANDROID
if (FileUtil::Exists(ROOT_DIR DIR_SEP SDCARD_DIR)) {
user_path = ROOT_DIR DIR_SEP SDCARD_DIR DIR_SEP EMU_DATA_DIR DIR_SEP;
g_paths.emplace(UserPath::ConfigDir, user_path + CONFIG_DIR DIR_SEP);
g_paths.emplace(UserPath::CacheDir, user_path + CACHE_DIR DIR_SEP);
}
#else
if (FileUtil::Exists(ROOT_DIR DIR_SEP USERDATA_DIR)) {
user_path = ROOT_DIR DIR_SEP USERDATA_DIR DIR_SEP;
g_paths.emplace(UserPath::ConfigDir, user_path + CONFIG_DIR DIR_SEP);
g_paths.emplace(UserPath::CacheDir, user_path + CACHE_DIR DIR_SEP);
} else {
std::string data_dir = GetUserDirectory("XDG_DATA_HOME");
std::string config_dir = GetUserDirectory("XDG_CONFIG_HOME");
std::string cache_dir = GetUserDirectory("XDG_CACHE_HOME");
user_path = data_dir + DIR_SEP EMU_DATA_DIR DIR_SEP;
g_paths.emplace(UserPath::ConfigDir, config_dir + DIR_SEP EMU_DATA_DIR DIR_SEP);
g_paths.emplace(UserPath::CacheDir, cache_dir + DIR_SEP EMU_DATA_DIR DIR_SEP);
}
#endif
2014-04-01 22:20:08 +00:00
}
g_paths.emplace(UserPath::SDMCDir, user_path + SDMC_DIR DIR_SEP);
g_paths.emplace(UserPath::NANDDir, user_path + NAND_DIR DIR_SEP);
g_paths.emplace(UserPath::SysDataDir, user_path + SYSDATA_DIR DIR_SEP);
// TODO: Put the logs in a better location for each OS
g_paths.emplace(UserPath::LogDir, user_path + LOG_DIR DIR_SEP);
g_paths.emplace(UserPath::CheatsDir, user_path + CHEATS_DIR DIR_SEP);
g_paths.emplace(UserPath::DLLDir, user_path + DLL_DIR DIR_SEP);
g_paths.emplace(UserPath::ShaderDir, user_path + SHADER_DIR DIR_SEP);
2019-04-03 01:29:36 +00:00
g_paths.emplace(UserPath::DumpDir, user_path + DUMP_DIR DIR_SEP);
g_paths.emplace(UserPath::LoadDir, user_path + LOAD_DIR DIR_SEP);
}
const std::string& GetUserPath(UserPath path) {
// Set up all paths and files on the first run
if (g_paths.empty())
SetUserPath();
return g_paths[path];
}
Port yuzu-emu/yuzu#2511: "common/file_util: Minor cleanup" (#4782) * common/file_util: Make IOFile's WriteString take a std::string_view We don't need to force the usage of a std::string here, and can instead use a std::string_view, which allows writing out other forms of strings (e.g. C-style strings) without any unnecessary heap allocations. * common/file_util: Remove unnecessary c_str() calls The file stream open functions have supported std::string overloads since C++11, so we don't need to use c_str() here. Same behavior, less code. * common/file_util: Make ReadFileToString and WriteStringToFile consistent Makes the parameter ordering consistent, and also makes the filename parameter a std::string. A std::string would be constructed anyways with the previous code, as IOFile's only constructor with a filepath is one taking a std::string. We can also make WriteStringToFile's string parameter utilize a std::string_view for the string, making use of our previous changes to IOFile. * common/file_util: Remove duplicated documentation comments These are already present within the header, so they don't need to be repeated in the cpp file. * common/file_util: Make GetCurrentDir() return a std::optional nullptr was being returned in the error case, which, at a glance may seem perfectly OK... until you realize that std::string has the invariant that it may not be constructed from a null pointer. This means that if this error case was ever hit, then the application would most likely crash from a thrown exception in std::string's constructor. Instead, we can change the function to return an optional value, indicating if a failure occurred. * common/file_util: Remove unnecessary return at end of void StripTailDirSlashes() While we're at it, also invert the conditional into a guard clause.
2019-06-07 22:23:57 +00:00
std::size_t WriteStringToFile(bool text_file, const std::string& filename, std::string_view str) {
return IOFile(filename, text_file ? "w" : "wb").WriteString(str);
}
Port yuzu-emu/yuzu#2511: "common/file_util: Minor cleanup" (#4782) * common/file_util: Make IOFile's WriteString take a std::string_view We don't need to force the usage of a std::string here, and can instead use a std::string_view, which allows writing out other forms of strings (e.g. C-style strings) without any unnecessary heap allocations. * common/file_util: Remove unnecessary c_str() calls The file stream open functions have supported std::string overloads since C++11, so we don't need to use c_str() here. Same behavior, less code. * common/file_util: Make ReadFileToString and WriteStringToFile consistent Makes the parameter ordering consistent, and also makes the filename parameter a std::string. A std::string would be constructed anyways with the previous code, as IOFile's only constructor with a filepath is one taking a std::string. We can also make WriteStringToFile's string parameter utilize a std::string_view for the string, making use of our previous changes to IOFile. * common/file_util: Remove duplicated documentation comments These are already present within the header, so they don't need to be repeated in the cpp file. * common/file_util: Make GetCurrentDir() return a std::optional nullptr was being returned in the error case, which, at a glance may seem perfectly OK... until you realize that std::string has the invariant that it may not be constructed from a null pointer. This means that if this error case was ever hit, then the application would most likely crash from a thrown exception in std::string's constructor. Instead, we can change the function to return an optional value, indicating if a failure occurred. * common/file_util: Remove unnecessary return at end of void StripTailDirSlashes() While we're at it, also invert the conditional into a guard clause.
2019-06-07 22:23:57 +00:00
std::size_t ReadFileToString(bool text_file, const std::string& filename, std::string& str) {
IOFile file(filename, text_file ? "r" : "rb");
if (!file)
2014-04-01 22:20:08 +00:00
return false;
str.resize(static_cast<u32>(file.GetSize()));
2014-04-01 22:20:08 +00:00
return file.ReadArray(&str[0], str.size());
}
void SplitFilename83(const std::string& filename, std::array<char, 9>& short_name,
std::array<char, 4>& extension) {
const std::string forbidden_characters = ".\"/\\[]:;=, ";
// On a FAT32 partition, 8.3 names are stored as a 11 bytes array, filled with spaces.
short_name = {{' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', '\0'}};
extension = {{' ', ' ', ' ', '\0'}};
std::string::size_type point = filename.rfind('.');
if (point == filename.size() - 1)
point = filename.rfind('.', point);
// Get short name.
int j = 0;
for (char letter : filename.substr(0, point)) {
if (forbidden_characters.find(letter, 0) != std::string::npos)
continue;
if (j == 8) {
// TODO(Link Mauve): also do that for filenames containing a space.
// TODO(Link Mauve): handle multiple files having the same short name.
short_name[6] = '~';
short_name[7] = '1';
break;
}
short_name[j++] = toupper(letter);
}
// Get extension.
if (point != std::string::npos) {
j = 0;
for (char letter : filename.substr(point + 1, 3))
extension[j++] = toupper(letter);
}
}
IOFile::IOFile() {}
IOFile::IOFile(const std::string& filename, const char openmode[], int flags) {
Open(filename, openmode, flags);
}
IOFile::~IOFile() {
2014-04-01 22:20:08 +00:00
Close();
}
IOFile::IOFile(IOFile&& other) {
2014-04-01 22:20:08 +00:00
Swap(other);
}
IOFile& IOFile::operator=(IOFile&& other) {
2014-04-01 22:20:08 +00:00
Swap(other);
return *this;
}
void IOFile::Swap(IOFile& other) {
2014-04-01 22:20:08 +00:00
std::swap(m_file, other.m_file);
std::swap(m_good, other.m_good);
}
bool IOFile::Open(const std::string& filename, const char openmode[], int flags) {
2014-04-01 22:20:08 +00:00
Close();
#ifdef _WIN32
if (flags != 0) {
m_file = _wfsopen(Common::UTF8ToUTF16W(filename).c_str(),
Common::UTF8ToUTF16W(openmode).c_str(), flags);
} else {
_wfopen_s(&m_file, Common::UTF8ToUTF16W(filename).c_str(),
Common::UTF8ToUTF16W(openmode).c_str());
}
#else
2014-04-01 22:20:08 +00:00
m_file = fopen(filename.c_str(), openmode);
#endif
2014-04-01 22:20:08 +00:00
m_good = IsOpen();
return m_good;
}
bool IOFile::Close() {
2014-04-01 22:20:08 +00:00
if (!IsOpen() || 0 != std::fclose(m_file))
m_good = false;
2014-12-03 18:57:57 +00:00
m_file = nullptr;
2014-04-01 22:20:08 +00:00
return m_good;
}
u64 IOFile::GetSize() const {
2014-04-01 22:20:08 +00:00
if (IsOpen())
return FileUtil::GetSize(m_file);
return 0;
}
bool IOFile::Seek(s64 off, int origin) {
2014-04-01 22:20:08 +00:00
if (!IsOpen() || 0 != fseeko(m_file, off, origin))
m_good = false;
2014-04-01 22:20:08 +00:00
return m_good;
}
u64 IOFile::Tell() const {
2014-04-01 22:20:08 +00:00
if (IsOpen())
return ftello(m_file);
return -1;
}
bool IOFile::Flush() {
2014-04-01 22:20:08 +00:00
if (!IsOpen() || 0 != std::fflush(m_file))
m_good = false;
2014-04-01 22:20:08 +00:00
return m_good;
}
bool IOFile::Resize(u64 size) {
if (!IsOpen() || 0 !=
#ifdef _WIN32
// ector: _chsize sucks, not 64-bit safe
// F|RES: changed to _chsize_s. i think it is 64-bit safe
_chsize_s(_fileno(m_file), size)
#else
// TODO: handle 64bit and growing
ftruncate(fileno(m_file), size)
#endif
)
2014-04-01 22:20:08 +00:00
m_good = false;
2014-04-01 22:20:08 +00:00
return m_good;
}
} // namespace FileUtil