Postconditions: empty() is true.

path(const path& p); path(path&& p) noexcept;

Effects: Constructs an object of class path having the same pathname in the native and generic formats, respectively, as the original value of p.

In the second form, p is left in a valid but unspecified state.

path(string_type&& source, format fmt = auto_format);

Effects: Constructs an object of class path for which the pathname in the detected-format of source has the original value of source ([fs.path.fmt.cvt]), converting format if required ([fs.path.fmt.cvt]).

source is left in a valid but unspecified state.

template<class Source> path(const Source& source, format fmt = auto_format); template<class InputIterator> path(InputIterator first, InputIterator last, format fmt = auto_format);

Effects: Let s be the effective range of source ([fs.path.req]) or the range [first, last), with the encoding converted if required ([fs.path.cvt]).

Finds the detected-format of s ([fs.path.fmt.cvt]) and constructs an object of class path for which the pathname in that format is s.

template<class Source> path(const Source& source, const locale& loc, format fmt = auto_format); template<class InputIterator> path(InputIterator first, InputIterator last, const locale& loc, format fmt = auto_format);

Mandates: The value type of Source and InputIterator is char.

Effects: Let s be the effective range of source or the range [first, last), after converting the encoding as follows:

• If value_type is wchar_t, converts to the native wide encoding ([fs.path.type.cvt]) using the codecvt<​wchar_t, char, mbstate_t> facet of loc.

• Otherwise a conversion is performed using the codecvt<wchar_t, char, mbstate_t> facet of loc, and then a second conversion to the current ordinary encoding.

path& operator=(const path& p);

Effects: If *this and p are the same object, has no effect.

Otherwise, sets both respective pathnames of *this to the respective pathnames of p.

path& operator=(path&& p) noexcept;

Effects: If *this and p are the same object, has no effect.

Otherwise, sets both respective pathnames of *this to the respective pathnames of p.

p is left in a valid but unspecified state.

path& operator=(string_type&& source); path& assign(string_type&& source);

Effects: Sets the pathname in the detected-format of source to the original value of source.

source is left in a valid but unspecified state.

template<class Source> path& operator=(const Source& source); template<class Source> path& assign(const Source& source); template<class InputIterator> path& assign(InputIterator first, InputIterator last);

Effects: Let s be the effective range of source ([fs.path.req]) or the range [first, last), with the encoding converted if required ([fs.path.cvt]).

Finds the detected-format of s ([fs.path.fmt.cvt]) and sets the pathname in that format to s.

The append operations use operator/= to denote their semantic effect of appending preferred-separator when needed.

path& operator/=(const path& p);

Effects: If p.is_absolute() || (p.has_root_name() && p.root_name() != root_name()), then operator=(p).

Otherwise, modifies *this as if by these steps:

• If p.has_root_directory(), then removes any root directory and relative path from the generic format pathname.

  Otherwise, if !has_root_directory() && is_absolute() is true or if has_filename() is true, then appends path​::​preferred_separator to the generic format pathname.

• Then appends the native format pathname of p, omitting any root-name from its generic format pathname, to the native format pathname.

template<class Source> path& operator/=(const Source& source); template<class Source> path& append(const Source& source);

Effects: Equivalent to: return operator/=(path(source));

template<class InputIterator> path& append(InputIterator first, InputIterator last);

Effects: Equivalent to: return operator/=(path(first, last));

path& operator+=(const path& x); path& operator+=(const string_type& x); path& operator+=(basic_string_view<value_type> x); path& operator+=(const value_type* x); template<class Source> path& operator+=(const Source& x); template<class Source> path& concat(const Source& x);

Effects: Appends path(x).native() to the pathname in the native format.

path& operator+=(value_type x); template<class EcharT> path& operator+=(EcharT x);

Effects: Equivalent to: return *this += basic_string_view(&x, 1);

template<class InputIterator> path& concat(InputIterator first, InputIterator last);

Effects: Equivalent to: return *this += path(first, last);

Postconditions: empty() is true.

[Example 1: path p("foo/bar"); std::cout << p << '\n'; p.make_preferred(); std::cout << p << '\n';

On an operating system where preferred-separator is a slash, the output is: "foo/bar" "foo/bar"

On an operating system where preferred-separator is a backslash, the output is: "foo/bar" "foo\bar"

— end example]

Effects: Remove the generic format pathname of filename() from the generic format pathname.

Postconditions: !has_filename().

[Example 2: path("foo/bar").remove_filename(); path("foo/").remove_filename(); path("/foo").remove_filename(); path("/").remove_filename(); — end example]

path& replace_filename(const path& replacement);

Effects: Equivalent to: remove_filename(); operator/=(replacement);

[Example 3: path("/foo").replace_filename("bar"); path("/").replace_filename("bar"); — end example]

path& replace_extension(const path& replacement = path());

Effects:

• Any existing extension() ([fs.path.decompose]) is removed from the pathname in the generic format, then
• If replacement is not empty and does not begin with a dot character, a dot character is appended to the pathname in the generic format, then
• operator+=(replacement);.

void swap(path& rhs) noexcept;

Effects: Swaps the contents (in all formats) of the two paths.

Complexity: Constant time.

The string returned by all native format observers is in the native pathname format ([fs.class.path]).

const string_type& native() const noexcept;

Returns: The pathname in the native format.

const value_type* c_str() const noexcept;

Effects: Equivalent to: return native().c_str();

operator string_type() const;

template<class EcharT, class traits = char_traits<EcharT>, class Allocator = allocator<EcharT>> basic_string<EcharT, traits, Allocator> string(const Allocator& a = Allocator()) const;

Remarks: All memory allocation, including for the return value, shall be performed by a.

std::string system_encoded_string() const; std::wstring wstring() const; std::u8string u8string() const; std::u16string u16string() const; std::u32string u32string() const;

Remarks: Conversion, if any, is performed as specified by [fs.path.cvt].

std::string display_string() const;

Returns: std​::​format("{}", *this).

[Example 1:

On an operating system that uses backslash as its preferred-separator, path("foo\\bar").generic_string() returns "foo/bar".

— end example]

template<class EcharT, class traits = char_traits<EcharT>, class Allocator = allocator<EcharT>> basic_string<EcharT, traits, Allocator> generic_string(const Allocator& a = Allocator()) const;

Returns: The pathname in the generic format.

Remarks: All memory allocation, including for the return value, shall be performed by a.

std::string generic_system_encoded_string() const; std::wstring generic_wstring() const; std::u8string generic_u8string() const; std::u16string generic_u16string() const; std::u32string generic_u32string() const;

Returns: The pathname in the generic format.

std::string generic_display_string() const;

Returns: std​::​format("{:g}", *this).

int compare(const path& p) const noexcept;

Returns:

• Let rootNameComparison be the result of this->root_name().native().compare(p.root_name().native()).

  If rootNameComparison is not 0, rootNameComparison.

• Otherwise, if !this->has_root_directory() and p.has_root_directory(), a value less than 0.

• Otherwise, if this->has_root_directory() and !p.has_root_directory(), a value greater than 0.

• Otherwise, if native() for the elements of this->relative_path() are lexicographically less than native() for the elements of p.relative_path(), a value less than 0.

• Otherwise, if native() for the elements of this->relative_path() are lexicographically greater than native() for the elements of p.relative_path(), a value greater than 0.

int compare(const string_type& s) const; int compare(basic_string_view<value_type> s) const; int compare(const value_type* s) const;

Effects: Equivalent to: return compare(path(s));

Returns: root-name, if the pathname in the generic format includes root-name, otherwise path().

path root_directory() const;

Returns: root_name() / root_directory().

path relative_path() const;

Returns: A path composed from the pathname in the generic format, if empty() is false, beginning with the first filename after root_path().

Otherwise, path().

path parent_path() const;

Returns: *this if has_relative_path() is false, otherwise a path whose generic format pathname is the longest prefix of the generic format pathname of *this that produces one fewer element in its iteration.

Returns: relative_path().empty() ? path() : *--end().

[Example 1: path("/foo/bar.txt").filename(); path("/foo/bar").filename(); path("/foo/bar/").filename(); path("/").filename(); path("//host").filename(); path(".").filename(); path("..").filename(); — end example]

Returns: Let f be the generic format pathname of filename().

[Example 2: std::cout << path("/foo/bar.txt").stem(); path p = "foo.bar.baz.tar"; for (; !p.extension().empty(); p = p.stem()) std::cout << p.extension() << '\n'; — end example]

Returns: A path whose pathname in the generic format is the suffix of filename() not included in stem().

[Example 3: path("/foo/bar.txt").extension(); path("/foo/bar").extension(); path("/foo/.profile").extension(); path(".bar").extension(); path("..bar").extension(); — end example]

[Note 1:

The period is included in the return value so that it is possible to distinguish between no extension and an empty extension.

— end note]

[Note 2:

On non-POSIX operating systems, for a path p, it is possible that p.stem() + p.extension() == p.filename() is false, even though the generic format pathnames are the same.

— end note]

bool empty() const noexcept;

Returns: true if the pathname in the generic format is empty, otherwise false.

bool has_root_path() const;

Returns: !root_path().empty().

bool has_root_name() const;

Returns: !root_name().empty().

bool has_root_directory() const;

Returns: !root_directory().empty().

bool has_relative_path() const;

Returns: !relative_path().empty().

bool has_parent_path() const;

Returns: !parent_path().empty().

bool has_filename() const;

Returns: !filename().empty().

Returns: !stem().empty().

bool has_extension() const;

Returns: !extension().empty().

bool is_absolute() const;

Returns: true if the pathname in the native format contains an absolute path ([fs.class.path]), otherwise false.

[Example 1:

path("/").is_absolute() is true for POSIX-based operating systems, and false for Windows-based operating systems.

— end example]

bool is_relative() const;

path lexically_normal() const;

Returns: A path whose pathname in the generic format is the normal form ([fs.path.generic]) of the pathname in the generic format of *this.

[Example 1: assert(path("foo/./bar/..").lexically_normal() == "foo/"); assert(path("foo/.///bar/../").lexically_normal() == "foo/");

The above assertions will succeed.

On Windows, the returned path's directory-separator characters will be backslashes rather than slashes, but that does not affect path equality.

— end example]

path lexically_relative(const path& base) const;

Determines the first mismatched element of *this and base as if by: auto [a, b] = mismatch(begin(), end(), base.begin(), base.end());

Returns: *this made relative to base.

[Example 2: assert(path("/a/d").lexically_relative("/a/b/c") == "../../d"); assert(path("/a/b/c").lexically_relative("/a/d") == "../b/c"); assert(path("a/b/c").lexically_relative("a") == "b/c"); assert(path("a/b/c").lexically_relative("a/b/c/x/y") == "../.."); assert(path("a/b/c").lexically_relative("a/b/c") == "."); assert(path("a/b").lexically_relative("c/d") == "../../a/b");

The above assertions will succeed.

On Windows, the returned path's directory-separator characters will be backslashes rather than slashes, but that does not affect path equality.

— end example]

[Note 2:

If symlink following semantics are desired, use the operational function relative().

— end note]

[Note 3:

If normalization ([fs.path.generic]) is needed to ensure consistent matching of elements, apply lexically_normal() to *this, base, or both.

— end note]

path lexically_proximate(const path& base) const;

Returns: If the value of lexically_relative(base) is not an empty path, return it.

Otherwise return *this.

[Note 4:

If symlink following semantics are desired, use the operational function proximate().

— end note]

[Note 5:

If normalization ([fs.path.generic]) is needed to ensure consistent matching of elements, apply lexically_normal() to *this, base, or both.

— end note]