SysTutorials

Linux Manual Pages › Section 3

stdfilesystempathoperator(3)

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).

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 null-terminated character/wide character sequence. The character type must be one of char,
source – 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
}

See also

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