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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::filesystem::path::parent_path - std::filesystem::path::parent_path

Synopsis
	  path parent_path() const;  (since C++17)

	  Returns the path to the parent directory.

	  If has_relative_path() returns false,	the result is a	copy of	*this.
       Otherwise, the
	  result is a path whose generic format	pathname is the	longest	prefix
       of the generic
	  format  pathname of *this that produces one fewer element in its it-
       eration.

Parameters
	  (none)

Return value
	  The path to the parent directory, or a copy of *this if not has_rel-
       ative_path().

Exceptions
	  May throw implementation-defined exceptions.

Example
       // Run this code

	#include <iostream>
	#include <filesystem>
	namespace fs = std::filesystem;
	int main()
	{
	    for(fs::path p : {"/var/tmp/example.txt", "/", "/var/tmp/."})
		std::cout << "The parent path of " << p
			  << " is " << p.parent_path() << '\n';
	}

Possible output:
	The parent path	of "/var/tmp/example.txt" is "/var/tmp"
	The parent path	of "/" is "/"
	The parent path	of "/var/tmp/."	is "/var/tmp"

See also
	  root_name	 returns the root-name of the path, if present
			 (public member	function)
	  root_directory returns the root directory of the path, if present
			 (public member	function)
	  root_path	 returns the root path of the path, if present
			 (public member	function)

http://cppreference.com		  2022.07.31	  std::filesy...parent_path(3)

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

home | help