std::filesystem::path::make_preferred
From cppreference.com
< cpp | filesystem | path
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
std::filesystem::path
path::make_preferred
(until C++20)(until C++20)(until C++20)(until C++20)(until C++20)(C++20)
path& make_preferred();
(since C++17)
Converts all directory separators in the generic-format view of the path to the preferred directory separator.
For example, on Windows, where \ is the preferred separator, the path foo/bar will be converted to foo\bar.
[edit] Parameters
(none)
[edit] Return value
*this
[edit] Exceptions
May throw implementation-defined exceptions.
[edit] Example
Windows can use / as a separator, but prefers \, so make_preferred converts the forward slashes to backslashes. On the other hand, POSIX does not use \ as a separator, because backslashes are valid filename characters — the Windows path on POSIX actually refers to a file with the name "a\\b\\c". For this reason the "separators" are not converted.
Run this code
#include <filesystem> #include <iostream> int main() { std::filesystem::path windows_path("a\\b\\c"), posix_path("a/b/c"); std::cout << "Windows path: " << windows_path << " -> " << windows_path.make_preferred() << '\n' << "POSIX path: " << posix_path << " -> " << posix_path.make_preferred() << '\n'; }
Output:
// on Windows Windows path: "a\\b\\c" -> "a\\b\\c" POSIX path: "a/b/c" -> "a\\b\\c" // on POSIX Windows path: "a\\b\\c" -> "a\\b\\c" POSIX path: "a/b/c" -> "a/b/c"
[edit] See also
constexpr value_type preferred_separator
[static]
(public static member constant) [edit]