path.h

Go to the documentation of this file.

 
#pragma once
 
#include <initializer_list>
#include <string>
#include <string_view>
#include <vector>
 
#include <rex/platform.h>
#include <rex/types.h>
 
namespace rex::string {
 
constexpr char32_t kUTF8PathSeparator = static_cast<char32_t>(rex::platform::kPathSeparator);
constexpr char32_t kUTF8GuestPathSeparator = U'\\';

REX_API std::vector<std::string_view> utf8_split_path(const std::string_view path);
 
REX_API std::string_view utf8_strip_leading_slashes(const std::string_view path);

REX_API std::string utf8_join_paths(const std::string_view left_path,
                                    const std::string_view right_path,
                                    char32_t separator = kUTF8PathSeparator);
 
REX_API std::string utf8_join_paths(const std::vector<std::string>& paths,
                                    char32_t separator = kUTF8PathSeparator);
 
REX_API std::string utf8_join_paths(const std::vector<std::string_view>& paths,
                                    char32_t separator = kUTF8PathSeparator);
 
inline std::string utf8_join_paths(std::initializer_list<const std::string_view> paths,
                                   char32_t separator = kUTF8PathSeparator) {
  std::string result;
  for (auto path : paths) {
    result = utf8_join_paths(result, path, separator);
  }
  return result;
}
 
inline std::string utf8_join_guest_paths(const std::string_view left_path,
                                         const std::string_view right_path) {
  return utf8_join_paths(left_path, right_path, kUTF8GuestPathSeparator);
}
 
inline std::string utf8_join_guest_paths(const std::vector<std::string>& paths) {
  return utf8_join_paths(paths, kUTF8GuestPathSeparator);
}
 
inline std::string utf8_join_guest_paths(const std::vector<std::string_view>& paths) {
  return utf8_join_paths(paths, kUTF8GuestPathSeparator);
}
 
inline std::string utf8_join_guest_paths(std::initializer_list<const std::string_view> paths) {
  return utf8_join_paths(paths, kUTF8GuestPathSeparator);
}

REX_API std::string utf8_fix_path_separators(const std::string_view path,
                                             char32_t new_separator = kUTF8PathSeparator);

REX_API std::string utf8_find_name_from_path(const std::string_view path,
                                             char32_t separator = kUTF8PathSeparator);
 
inline std::string utf8_find_name_from_guest_path(const std::string_view path) {
  return utf8_find_name_from_path(path, kUTF8GuestPathSeparator);
}

REX_API std::string utf8_find_base_name_from_path(const std::string_view path,
                                                  char32_t separator = kUTF8PathSeparator);
 
inline std::string utf8_find_base_name_from_guest_path(const std::string_view path) {
  return utf8_find_base_name_from_path(path, kUTF8GuestPathSeparator);
}

REX_API std::string utf8_find_base_path(const std::string_view path,
                                        char32_t separator = kUTF8PathSeparator);
 
inline std::string utf8_find_base_guest_path(const std::string_view path) {
  return utf8_find_base_path(path, kUTF8GuestPathSeparator);
}

REX_API std::string utf8_canonicalize_path(const std::string_view path,
                                           char32_t separator = kUTF8PathSeparator);

REX_API std::string NormalizeGuestPath(std::string_view path);
 
inline std::string utf8_canonicalize_guest_path(const std::string_view path) {
  return utf8_canonicalize_path(path, kUTF8GuestPathSeparator);
}
 
}  // namespace rex::string