std::experimental::filesystem::path::operator=

From cppreference.com
< cpp‎ | experimental‎ | fs‎ | path
 
 
Experimental
Technical Specification
Filesystem library (filesystem TS)
Library fundamentals (library fundamentals TS)
Library fundamentals 2 (library fundamentals TS v2)
Library fundamentals 3 (library fundamentals TS v3)
Extensions for parallelism (parallelism TS)
Extensions for parallelism 2 (parallelism TS v2)
Extensions for concurrency (concurrency TS)
Extensions for concurrency 2 (concurrency TS v2)
Concepts (concepts TS)
Ranges (ranges TS)
Reflection (reflection TS)
Mathematical special functions (special functions TR)
Experimental Non-TS
Pattern Matching
Linear Algebra
std::execution
Contracts
2D Graphics
 
 
 
path& operator=( const path& p );
(1) (filesystem TS)
path& operator=( path&& p );
(2) (filesystem TS)
template< class Source >
path& operator=( const Source& source );
(3) (filesystem TS)
1) Replaces the contents of *this with a copy of the contents of p.
2) Replaces the contents of *this with p, possibly using move semantics: p is left in valid, but unspecified state.
3) Replaces the contents of *this with a new path value constructed from source as if by overload (4) of the path constructor. Equivalent to assign(source).

Parameters

p - a path to assign
source - a std::basic_string, 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, char16_t, char32_t, wchar_t

Return value

*this

Exceptions

1) (none)
2)
noexcept specification:  
noexcept
  
3) (none)

Example

#include <experimental/filesystem>
namespace fs = std::experimental::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
(public member function)
constructs a path
(public member function)