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 <filesystem>
	#include <iostream>
	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		  2024.06.10	 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.1.quarterly>

home | help