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

FreeBSD Manual Pages

  
 
  

home | help
std::filesy...th::filename(3) C++ Standard Libarystd::filesy...th::filename(3)

NAME
       std::filesystem::path::filename - std::filesystem::path::filename

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

	  Returns the generic-format filename component	of the path.

	  Equivalent to	relative_path().empty()	? path() : *--end().

Parameters
	  (none)

Return value
	  The filename identified by the path.

Exceptions
	  May throw implementation-defined exceptions.

Example
       // Run this code

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

	int main()
	{
	    std::cout
		<< fs::path( "/foo/bar.txt" ).filename() << '\n'
		<< fs::path( "/foo/.bar"    ).filename() << '\n'
		<< fs::path( "/foo/bar/"    ).filename() << '\n'
		<< fs::path( "/foo/."	    ).filename() << '\n'
		<< fs::path( "/foo/.."	    ).filename() << '\n'
		<< fs::path( "."	    ).filename() << '\n'
		<< fs::path( ".."	    ).filename() << '\n'
		<< fs::path( "/"	    ).filename() << '\n'
		<< fs::path( "//host"	    ).filename() << '\n';
	}

Output:
	"bar.txt"
	".bar"
	""
	"."
	".."
	"."
	".."
	""
	"host"

See also
	  extension	   returns the file extension path component
			   (public member function)
			   returns  the	 stem path component (filename without
       the final
	  stem		   extension)
			   (public member function)
	  replace_filename replaces the	last path component with another path
			   (public member function)
	  has_filename	   checks if the corresponding	path  element  is  not
       empty
			   (public member function)

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

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

home | help