src/filesys.h

   1 /*
   2 Minetest
   3 Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
   4
   5 This program is free software; you can redistribute it and/or modify
   6 it under the terms of the GNU Lesser General Public License as published by
   7 the Free Software Foundation; either version 2.1 of the License, or
   8 (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU Lesser General Public License for more details.
  14
  15 You should have received a copy of the GNU Lesser General Public License along
  16 with this program; if not, write to the Free Software Foundation, Inc.,
  17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18 */
  19
  20 #ifndef FILESYS_HEADER
  21 #define FILESYS_HEADER
  22
  23 #include <string>
  24 #include <vector>
  25 #include "exceptions.h"
  26
  27 #ifdef _WIN32 // WINDOWS
  28 #define DIR_DELIM "\\"
  29 #define FILESYS_CASE_INSENSITIVE 1
  30 #else // POSIX
  31 #define DIR_DELIM "/"
  32 #define FILESYS_CASE_INSENSITIVE 0
  33 #endif
  34
  35 namespace fs
  36 {
  37
  38 struct DirListNode
  39 {
  40         std::string name;
  41         bool dir;
  42 };
  43
  44 std::vector<DirListNode> GetDirListing(const std::string &path);
  45
  46 // Returns true if already exists
  47 bool CreateDir(const std::string &path);
  48
  49 bool PathExists(const std::string &path);
  50
  51 bool IsPathAbsolute(const std::string &path);
  52
  53 bool IsDir(const std::string &path);
  54
  55 bool IsDirDelimiter(char c);
  56
  57 // Only pass full paths to this one. True on success.
  58 // NOTE: The WIN32 version returns always true.
  59 bool RecursiveDelete(const std::string &path);
  60
  61 bool DeleteSingleFileOrEmptyDirectory(const std::string &path);
  62
  63 // Returns path to temp directory, can return "" on error
  64 std::string TempPath();
  65
  66 /* Multiplatform */
  67
  68 // The path itself not included
  69 void GetRecursiveSubPaths(const std::string &path, std::vector<std::string> &dst);
  70
  71 // Tries to delete all, returns false if any failed
  72 bool DeletePaths(const std::vector<std::string> &paths);
  73
  74 // Only pass full paths to this one. True on success.
  75 bool RecursiveDeleteContent(const std::string &path);
  76
  77 // Create all directories on the given path that don't already exist.
  78 bool CreateAllDirs(const std::string &path);
  79
  80 // Copy a regular file
  81 bool CopyFileContents(const std::string &source, const std::string &target);
  82
  83 // Copy directory and all subdirectories
  84 // Omits files and subdirectories that start with a period
  85 bool CopyDir(const std::string &source, const std::string &target);
  86
  87 // Check if one path is prefix of another
  88 // For example, "/tmp" is a prefix of "/tmp" and "/tmp/file" but not "/tmp2"
  89 // Ignores case differences and '/' vs. '\\' on Windows
  90 bool PathStartsWith(const std::string &path, const std::string &prefix);
  91
  92 // Remove last path component and the dir delimiter before and/or after it,
  93 // returns "" if there is only one path component.
  94 // removed: If non-NULL, receives the removed component(s).
  95 // count: Number of components to remove
  96 std::string RemoveLastPathComponent(const std::string &path,
  97                std::string *removed = NULL, int count = 1);
  98
  99 // Remove "." and ".." path components and for every ".." removed, remove
 100 // the last normal path component before it. Unlike AbsolutePath,
 101 // this does not resolve symlinks and check for existence of directories.
 102 std::string RemoveRelativePathComponents(std::string path);
 103
 104 bool safeWriteToFile(const std::string &path, const std::string &content);
 105
 106 }//fs
 107
 108 #endif
 109