NAME

std::filesystem::path::operator= - std::filesystem::path::operator=

Synopsis

path& operator=( const path& p ); (1) (since C++17)
path& operator=( path&& p ) noexcept; (2) (since C++17)
path& operator=( string_type&& source ); (3) (since C++17)
template< class Source > (4) (since C++17)
path& operator=( const Source& source );

1) Replaces the contents of *this with a pathname whose both native and generic
format representations equal those of p.
2) Replaces the contents of *this with a pathname whose both native and generic
format representations equal those of p, possibly using move semantics: p is left in
a valid, but unspecified state.
3) Replaces the contents of *this with a new path value constructed from
detected-format source, which is left in valid, but unspecified state. Equivalent to
assign(std::move(source)).
4) Replaces the contents of *this with a new path value constructed from
detected-format source as if by overload (4) of the path constructor. Equivalent to
assign(source).

(4) participates in overload resolution only if Source and path are not the same
type, and either:

* Source is a specialization of std::basic_string or std::basic_string_view, or
* std::iterator_traits<std::decay_t<Source>>::value_type is valid and denotes a
possibly const-qualified encoding character type (char,
char8_t,
(since C++20)char16_t, char32_t, or wchar_t).

Parameters

p - a path to assign
a std::basic_string, std::basic_string_view, pointer to a null-terminated
character/wide character string, or an input iterator that points to a
source - null-terminated character/wide character sequence. The character type must
be one of char,
char8_t,
(since C++20)char16_t, char32_t, wchar_t

Return value

*this

Example

// Run this code

#include <filesystem>
namespace fs = std::filesystem;
int main()
{
fs::path p = "C:/users/abcdef/AppData/Local";
p = p / "Temp"; // move assignment
const wchar_t* wstr = L"D:/猫.txt";
p = wstr; // assignment from a source
}

Defect reports

The following behavior-changing defect reports were applied retroactively to
previously published C++ standards.

DR Applied to Behavior as published Correct behavior
LWG 3244 C++17 constraint that Source cannot be path was added
missing

See also

assign assigns contents
(public member function)
constructor constructs a path
(public member function)