2010-11-29 19:13:04 +01:00
|
|
|
/*
|
2013-02-24 18:40:43 +01:00
|
|
|
Minetest
|
2013-02-24 19:38:45 +01:00
|
|
|
Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
|
2010-11-29 19:13:04 +01:00
|
|
|
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
2012-06-05 16:56:56 +02:00
|
|
|
it under the terms of the GNU Lesser General Public License as published by
|
|
|
|
the Free Software Foundation; either version 2.1 of the License, or
|
2010-11-29 19:13:04 +01:00
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
2012-06-05 16:56:56 +02:00
|
|
|
GNU Lesser General Public License for more details.
|
2010-11-29 19:13:04 +01:00
|
|
|
|
2012-06-05 16:56:56 +02:00
|
|
|
You should have received a copy of the GNU Lesser General Public License along
|
2010-11-29 19:13:04 +01:00
|
|
|
with this program; if not, write to the Free Software Foundation, Inc.,
|
|
|
|
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
|
|
*/
|
|
|
|
|
2017-08-17 22:19:39 +02:00
|
|
|
#pragma once
|
2010-11-27 00:02:21 +01:00
|
|
|
|
2017-09-13 22:03:18 +02:00
|
|
|
#include <set>
|
2010-11-27 00:02:21 +01:00
|
|
|
#include <string>
|
2024-02-17 15:35:33 +01:00
|
|
|
#include <string_view>
|
2010-11-27 00:02:21 +01:00
|
|
|
#include <vector>
|
|
|
|
|
2021-09-19 16:55:35 +02:00
|
|
|
#ifdef _WIN32
|
2011-10-16 15:16:47 +02:00
|
|
|
#define DIR_DELIM "\\"
|
2015-04-19 02:12:14 +02:00
|
|
|
#define DIR_DELIM_CHAR '\\'
|
2017-08-18 07:44:42 +02:00
|
|
|
#define FILESYS_CASE_INSENSITIVE true
|
2015-09-26 09:06:13 +02:00
|
|
|
#define PATH_DELIM ";"
|
2021-09-19 16:55:35 +02:00
|
|
|
#else
|
2011-10-16 15:16:47 +02:00
|
|
|
#define DIR_DELIM "/"
|
2015-04-19 02:12:14 +02:00
|
|
|
#define DIR_DELIM_CHAR '/'
|
2017-08-18 07:44:42 +02:00
|
|
|
#define FILESYS_CASE_INSENSITIVE false
|
2015-09-26 09:06:13 +02:00
|
|
|
#define PATH_DELIM ":"
|
2011-10-16 15:16:47 +02:00
|
|
|
#endif
|
|
|
|
|
2023-06-12 22:00:08 +02:00
|
|
|
namespace irr::io {
|
2021-05-06 09:02:11 +02:00
|
|
|
class IFileSystem;
|
2023-06-12 22:00:08 +02:00
|
|
|
}
|
2021-05-06 09:02:11 +02:00
|
|
|
|
2010-11-27 00:02:21 +01:00
|
|
|
namespace fs
|
|
|
|
{
|
|
|
|
|
|
|
|
struct DirListNode
|
|
|
|
{
|
|
|
|
std::string name;
|
|
|
|
bool dir;
|
|
|
|
};
|
2015-04-08 05:04:48 +02:00
|
|
|
|
|
|
|
std::vector<DirListNode> GetDirListing(const std::string &path);
|
2010-11-27 00:02:21 +01:00
|
|
|
|
|
|
|
// Returns true if already exists
|
2015-04-08 05:04:48 +02:00
|
|
|
bool CreateDir(const std::string &path);
|
|
|
|
|
|
|
|
bool PathExists(const std::string &path);
|
2010-11-27 00:02:21 +01:00
|
|
|
|
2015-04-08 05:04:48 +02:00
|
|
|
bool IsPathAbsolute(const std::string &path);
|
2010-11-27 00:02:21 +01:00
|
|
|
|
2015-04-08 05:04:48 +02:00
|
|
|
bool IsDir(const std::string &path);
|
2012-03-25 23:21:38 +02:00
|
|
|
|
2023-01-23 00:19:30 +01:00
|
|
|
bool IsExecutable(const std::string &path);
|
|
|
|
|
2022-05-07 17:44:46 +02:00
|
|
|
inline bool IsFile(const std::string &path)
|
|
|
|
{
|
|
|
|
return PathExists(path) && !IsDir(path);
|
|
|
|
}
|
|
|
|
|
2013-06-23 18:30:21 +02:00
|
|
|
bool IsDirDelimiter(char c);
|
|
|
|
|
2011-01-25 23:40:33 +01:00
|
|
|
// Only pass full paths to this one. True on success.
|
2011-01-26 00:06:45 +01:00
|
|
|
// NOTE: The WIN32 version returns always true.
|
2015-04-08 05:04:48 +02:00
|
|
|
bool RecursiveDelete(const std::string &path);
|
2011-01-25 23:40:33 +01:00
|
|
|
|
2015-04-08 05:04:48 +02:00
|
|
|
bool DeleteSingleFileOrEmptyDirectory(const std::string &path);
|
2012-03-25 23:21:38 +02:00
|
|
|
|
2013-06-23 18:30:21 +02:00
|
|
|
// Returns path to temp directory, can return "" on error
|
|
|
|
std::string TempPath();
|
|
|
|
|
2021-09-09 16:51:35 +02:00
|
|
|
// Returns path to securely-created temporary file (will already exist when this function returns)
|
|
|
|
// can return "" on error
|
|
|
|
std::string CreateTempFile();
|
|
|
|
|
2017-09-13 22:03:18 +02:00
|
|
|
/* Returns a list of subdirectories, including the path itself, but excluding
|
|
|
|
hidden directories (whose names start with . or _)
|
|
|
|
*/
|
|
|
|
void GetRecursiveDirs(std::vector<std::string> &dirs, const std::string &dir);
|
|
|
|
std::vector<std::string> GetRecursiveDirs(const std::string &dir);
|
|
|
|
|
2012-03-25 23:21:38 +02:00
|
|
|
/* Multiplatform */
|
|
|
|
|
2017-09-13 22:03:18 +02:00
|
|
|
/* The path itself not included, returns a list of all subpaths.
|
|
|
|
dst - vector that contains all the subpaths.
|
|
|
|
list files - include files in the list of subpaths.
|
|
|
|
ignore - paths that start with these charcters will not be listed.
|
|
|
|
*/
|
|
|
|
void GetRecursiveSubPaths(const std::string &path,
|
|
|
|
std::vector<std::string> &dst,
|
|
|
|
bool list_files,
|
|
|
|
const std::set<char> &ignore = {});
|
2012-03-25 23:21:38 +02:00
|
|
|
|
2011-01-25 23:40:33 +01:00
|
|
|
// Only pass full paths to this one. True on success.
|
2015-04-08 05:04:48 +02:00
|
|
|
bool RecursiveDeleteContent(const std::string &path);
|
2011-01-25 23:40:33 +01:00
|
|
|
|
2012-03-25 23:21:38 +02:00
|
|
|
// Create all directories on the given path that don't already exist.
|
2015-04-08 05:04:48 +02:00
|
|
|
bool CreateAllDirs(const std::string &path);
|
2012-03-25 23:21:38 +02:00
|
|
|
|
2013-06-23 18:30:21 +02:00
|
|
|
// Copy a regular file
|
2015-04-08 05:04:48 +02:00
|
|
|
bool CopyFileContents(const std::string &source, const std::string &target);
|
2013-06-23 18:30:21 +02:00
|
|
|
|
|
|
|
// Copy directory and all subdirectories
|
|
|
|
// Omits files and subdirectories that start with a period
|
2015-04-08 05:04:48 +02:00
|
|
|
bool CopyDir(const std::string &source, const std::string &target);
|
2013-06-23 18:30:21 +02:00
|
|
|
|
2021-09-19 18:16:53 +02:00
|
|
|
// Move directory and all subdirectories
|
|
|
|
// Behavior with files/subdirs that start with a period is undefined
|
|
|
|
bool MoveDir(const std::string &source, const std::string &target);
|
|
|
|
|
2013-06-23 18:30:21 +02:00
|
|
|
// Check if one path is prefix of another
|
|
|
|
// For example, "/tmp" is a prefix of "/tmp" and "/tmp/file" but not "/tmp2"
|
|
|
|
// Ignores case differences and '/' vs. '\\' on Windows
|
2015-04-08 05:04:48 +02:00
|
|
|
bool PathStartsWith(const std::string &path, const std::string &prefix);
|
2013-06-23 18:30:21 +02:00
|
|
|
|
|
|
|
// Remove last path component and the dir delimiter before and/or after it,
|
|
|
|
// returns "" if there is only one path component.
|
|
|
|
// removed: If non-NULL, receives the removed component(s).
|
|
|
|
// count: Number of components to remove
|
2015-04-08 05:04:48 +02:00
|
|
|
std::string RemoveLastPathComponent(const std::string &path,
|
2023-05-26 15:13:57 +02:00
|
|
|
std::string *removed = NULL, int count = 1);
|
2013-06-23 18:30:21 +02:00
|
|
|
|
|
|
|
// Remove "." and ".." path components and for every ".." removed, remove
|
|
|
|
// the last normal path component before it. Unlike AbsolutePath,
|
|
|
|
// this does not resolve symlinks and check for existence of directories.
|
|
|
|
std::string RemoveRelativePathComponents(std::string path);
|
|
|
|
|
2014-09-06 02:08:51 +02:00
|
|
|
// Returns the absolute path for the passed path, with "." and ".." path
|
|
|
|
// components and symlinks removed. Returns "" on error.
|
|
|
|
std::string AbsolutePath(const std::string &path);
|
|
|
|
|
|
|
|
// Returns the filename from a path or the entire path if no directory
|
|
|
|
// delimiter is found.
|
2015-04-26 07:24:19 +02:00
|
|
|
const char *GetFilenameFromPath(const char *path);
|
|
|
|
|
2024-02-17 15:35:33 +01:00
|
|
|
bool safeWriteToFile(const std::string &path, std::string_view content);
|
2013-08-13 19:15:06 +02:00
|
|
|
|
2021-09-19 16:55:35 +02:00
|
|
|
#ifndef SERVER
|
2021-05-06 09:02:11 +02:00
|
|
|
bool extractZipFile(irr::io::IFileSystem *fs, const char *filename, const std::string &destination);
|
2021-09-19 16:55:35 +02:00
|
|
|
#endif
|
2021-05-06 09:02:11 +02:00
|
|
|
|
2020-09-16 15:51:11 +02:00
|
|
|
bool ReadFile(const std::string &path, std::string &out);
|
|
|
|
|
2015-08-24 23:00:06 +02:00
|
|
|
bool Rename(const std::string &from, const std::string &to);
|
|
|
|
|
2014-09-06 02:08:51 +02:00
|
|
|
} // namespace fs
|