path.hh

Go to the documentation of this file.

 // This Source Code Form is licensed MPL-2.0: http://mozilla.org/MPL/2.0
#pragma once
 
#include <ase/cxxaux.hh>
 
#ifdef  _WIN32 // includes _WIN64
#define ASE_UNIX_PATHS                  0       
#define ASE_DOS_PATHS                   1       
#define ASE_DIRSEP                     '/'
#define ASE_DIRSEP2                    '\\'
#define ASE_DIRSEPARATORS               "/\\"
#define ASE_SEARCHPATH_SEPARATOR        ';'
#define ASE_LIBEXT                      ".dll"
#else   // !_WIN32
#define ASE_UNIX_PATHS                  1       
#define ASE_DOS_PATHS                   0       
#define ASE_DIRSEP                     '/'      
#define ASE_DIRSEP2                    '/'      
#define ASE_DIRSEPARATORS               "/"     
#define ASE_SEARCHPATH_SEPARATOR        ':'     
#define ASE_LIBEXT                      ".so"   
#endif  // !_WIN32
#define ASE_PATH_MAX    (PATH_MAX > 4096 ? PATH_MAX : 4096)
 
namespace Ase {
 
namespace Path {
 
String       dirname             (const String &path);
String       basename            (const String &path);
String       normalize           (const String &path);
String       realpath            (const String &path);
String       dir_terminate       (const String &path);
String       strip_slashes       (const String &path);
String       abspath             (const String &path, const String &incwd = "");
bool         isabs               (const String &path);
bool         isroot              (const String &path, bool dos_drives = ASE_DOS_PATHS);
bool         isdirname           (const String &path);
bool         dircontains         (const String &dirpath, const String &descendant, String *relpath = nullptr);
bool         mkdirs              (const String &dirpath, uint mode = 0750);
void         rmrf                (const String &dir);
bool         copy_file           (const String &src, const String &dest);
bool         rename              (const String &src, const String &dest);
size_t       file_size           (const String &path);
StringPair   split_extension     (const std::string &filepath, bool lastdot = false);
String       expand_tilde        (const String &path);
String       user_home           (const String &username = "");
String       xdg_dir             (const String &xdgdir = "");
String       data_home           ();
String       config_home         ();
String       config_names        ();
void         config_names        (const String &names);
String       cache_home          ();
String       runtime_dir         ();
String       config_dirs         ();
String       data_dirs           ();
String       skip_root           (const String &path);
template<class ...S>
String       join                (String path, const S &...more);
bool         check               (const String &file, const String &mode);
bool         equals              (const String &file1, const String &file2);
char*        memread             (const String &filename, size_t *lengthp, ssize_t maxlength = -1);
void         memfree             (char         *memread_mem);
bool         memwrite            (const String &filename, size_t len, const uint8 *bytes, bool append = false, int perms = -1);
String       stringread          (const String &filename, ssize_t maxlength = -1);
bool         stringwrite         (const String &filename, const String &data, bool mkdirs = false, int perms = -1);
bool         stringappend        (const String &filename, const String &data, bool mkdirs = false, int perms = -1);
String       cwd                 ();
String       vpath_find          (const String &file, const String &mode = "e");
String       simplify_abspath    (const std::string &abspath_expression);
bool         searchpath_contains (const String &searchpath, const String &element);
String       searchpath_find     (const String &searchpath, const String &file, const String &mode = "e");
StringS      searchpath_list     (const String &searchpath, const String &mode = "e");
String       searchpath_multiply (const String &searchpath, const String &postfixes);
StringS      searchpath_split    (const String &searchpath);
String       searchpath_join     (const StringS &string_vector);
template<class ...S>
String       searchpath_join     (String path, const S &...more);
void         glob                (const String &pathpattern, StringS &matches);
void         glob                (const String &pathpattern, StringS &dirs, StringS &files);
void         rglob               (const String &basedir, const String &pattern, StringS &matches);
void         unique_realpaths    (StringS &pathnames);
StringS      list_old_files      (const String &abspath_glob, double min_age_seconds);
String       glob_stem           (const String &abspath_glob, const String &matched_path);
 
// == implementations ==
String join_with (const String &head, char joiner, const String &tail);
 
template<class ...S> inline String
join (String path, const S &...more)
{
  ((path = join_with (path, ASE_DIRSEP, more)), ...); // C++17 fold expression
  return path;
}
 
template<class ...S> inline String
searchpath_join (String path, const S &...more)
{
  ((path = join_with (path, ASE_SEARCHPATH_SEPARATOR, more)), ...); // C++17 fold expression
  return path;
}
 
} // Path
} // Ase