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

FreeBSD Manual Pages

  
 
  

home | help 
std::experi...::path::path(3) C++ Standard Libarystd::experi...::path::path(3)

NAME
       std::experimental::filesystem::path::path - std::experimental::filesys-
       tem::path::path

Synopsis
	  path();							   (1)
       (filesystem TS)
	  path(	const  path&  p	 );					   (2)
       (filesystem TS)
	  path(	 path&&	 p  );						   (3)
       (filesystem TS)
	  template<  class  Source  >					   (4)
       (filesystem TS)
	  path(	const Source& source );
	  template<  class  InputIt  >					   (5)
       (filesystem TS)
	  path(	InputIt	first, InputIt last );
	  template<  class  Source  >					   (6)
       (filesystem TS)
	  path(	const Source& source, const std::locale& loc );
	  template<  class  InputIt  >					   (7)
       (filesystem TS)
	  path(	InputIt	first, InputIt last, const std::locale&	loc );

	  Constructs a new path	object.

	  1) Constructs	an empty path.
	  2) Copy constructor. Constructs a copy of p.
	  3) Move constructor. Constructs a copy of p, p is left in valid  but
       unspecified
	  state.
	  4,5)	Constructs  the	 path  from  a	character sequence provided by
       source (4), which is
	  a pointer or an input	iterator to a  null-terminated	character/wide
       character
	  sequence  or an std::basic_string, or	represented as a pair of input
       iterators
	  [first, last)	(5). Any of the	four character types  char,  char16_t,
       char32_t, wchar_t
	  is allowed, and the method of	conversion to the native character set
       depends on the
	  character type used by source.

	    * If the source character type is char, the	encoding of the	source
       is assumed to
	      be  the  native narrow encoding (so no conversion	takes place on
       POSIX systems).
	    * If the source character type is char16_t,	conversion from	UTF-16
       to native
	      filesystem encoding is used.
	    * If the source character type is char32_t,	conversion from	UTF-32
       to native
	      filesystem encoding is used.
	    * If the source character type is wchar_t, the input is assumed to
       be the native
	      wide encoding (so	no conversion takes places on Windows).
	  6,7) Constructs the path  from  a  character	sequence  provided  by
       source (6), which is
	  a  pointer  or  an input iterator to a null-terminated character se-
       quence or an
	  std::string, or represented as a pair	 of  input  iterators  [first,
       last) (7). The only
	  character  type  allowed  is char. Uses loc to perform the character
       encoding
	  conversion. If value_type is wchar_t,	converts from  to  wide	 using
       the
	  std::codecvt<wchar_t,	char, std::mbstate_t> facet of loc. Otherwise,
       first converts
	  to  wide using the std::codecvt<wchar_t, char, std::mbstate_t> facet
       and then
	  converts    to    filesystem	  native    character	 type	 using
       std::codecvt<wchar_t, value_type>
	  facet	of loc.

Parameters
	  p	      -	a path to copy
			a  std::basic_string,  pointer	to  a  null-terminated
       character string, or
	  source      -	an input iterator with a  character  value  type  that
       points to a
			null-terminated	character sequence (the	character type
       must be char
			for overload (6)
	  first,  last - pair of LegacyInputIterators that specify a UTF-8 en-
       coded character
			sequence
	  loc	      -	locale that defines encoding conversion	to use

Type requirements
	  -
	  InputIt must meet the	requirements of	LegacyInputIterator.
	  -
	  The value type of InputIt must be one	of the	four  character	 types
       char, wchar_t,
	  char16_t and char32_t	to use the overload (5).
	  -
	  The value type of InputIt must be char to use	the overload (7).

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

	  4-7) (none)

Notes
	  For portable pathname	generation from	Unicode	strings, see u8path.

Example
       // Run this code

	#include <experimental/filesystem>
	#include <iostream>
	namespace fs = std::experimental::filesystem;

	int main()
	{
	    fs::path p1	= "/usr/lib/sendmail.cf"; // portable format
	    fs::path  p2 = "C:\\users\\abcdef\\AppData\\Local\\Temp\\";	// na-
       tive format
	    fs::path p3	= L"D:/.txt"; // wide string

	    std::cout << "p1 = " << p1 << '\n'
		      << "p2 = " << p2 << '\n'
		      << "p3 = " << p3 << '\n';
	}

Output:
	p1 = "/usr/lib/sendmail.cf"
	p2 = "C:\users\abcdef\AppData\Local\Temp\"
	p3 = "D:/.txt"

See also
	  u8path creates a path	from a UTF-8 encoded source
		 (function)

Categories:
	    * Noindexed	pages
	    * unconditionally noexcept

Hidden categories:
	    * Pages with unreviewed unconditional noexcept template
	    * Pages with unreviewed noexcept template

http://cppreference.com		  2024.06.10	 std::experi...::path::path(3)

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

home | help