home | help 
std::filesy...path::assign(3)  C++ Standard Libary std::filesy...path::assign(3)

NAME
     std::filesystem::path::assign - std::filesystem::path::assign

Synopsis
	path& assign( string_type&& source );	     (1) (since C++17)
	template< class Source >		     (2) (since C++17)
	path& assign( const Source& source );
	template< class InputIt >		     (3) (since C++17)
	path& assign( InputIt first, InputIt last );

	Replaces  the  contents to the path object by a new pathname constructed
     from the
	given character sequence.

	1) Assigns the pathname identified by the detected-format string source,
     which is
	left in valid, but unspecified state.
	2) Assigns the pathname  identified  by  the  detected-format  character
     range source.
	3)  Assigns  the  pathname identified by detected-format character range
     [first, last).

	(2) 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::ba-
     sic_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
		      a character range to use, represented as std::string,
	source	     -	std::string_view, pointer to a null-terminated multibyte
     string, or as
		      an input iterator with char value type that points to a
		      null-terminated multibyte string
	first, last - a character range to use

Type requirements
	-
	InputIt must meet the requirements of LegacyInputIterator.
	-
	The value type of InputIt must be one of  the  encoded	character  types
     (char, wchar_t,
	char16_t and char32_t)

Return value
	*this

	Defect reports

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

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

See also
	operator= assigns another path
		  (public member function)

http://cppreference.com 	   2024.06.10	   std::filesy...path::assign(3)
home | help