Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
std::filesy...path::assign(3) C++ Standard Libarystd::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 con-
       structed	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	multi-
       byte 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
       Correct 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		  2022.07.31	 std::filesy...path::assign(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::filesystem::path::assign&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help