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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::filesystem::path::stem - std::filesystem::path::stem

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

	  Returns  the filename	identified by the generic-format path stripped
       of its
	  extension.

	  Returns the substring	from the beginning of filename() up to and not
       including the
	  last period (.) character, with the following	exceptions:

	    * If the first character in	the filename is	a period, that	period
       is ignored (a
	      filename like ".profile" is not treated as an extension).
	    *  If the filename is one of the special filesystem	components dot
       or dot-dot, or
	      if it has	no periods, the	 function  returns  the	 entire	 file-
       name().

Parameters
	  (none)

Return value
	  The  stem  of	the filename identified	by the path (i.e. the filename
       without the final
	  extension).

Exceptions
	  May throw implementation-defined exceptions.

Example
       // Run this code

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

	int main()
	{
	    for	  (const   fs::path   p	  :   {"/foo/bar.txt",	  "/foo/.bar",
       "foo.bar.baz.tar"})
		std::cout << "path: " << p << ", stem: " << p.stem() <<	'\n';

	    std::cout << '\n';

	    for	 (fs::path  p =	"foo.bar.baz.tar"; !p.extension().empty(); p =
       p.stem())
		std::cout << "path: " << p << ", extension: " << p.extension()
       << '\n';
	}

Output:
	path: "/foo/bar.txt", stem: "bar"
	path: "/foo/.bar", stem: ".bar"
	path: "foo.bar.baz.tar", stem: "foo.bar.baz"

	path: "foo.bar.baz.tar", extension: ".tar"
	path: "foo.bar.baz", extension:	".baz"
	path: "foo.bar", extension: ".bar"

See also
	  filename  returns the	filename path component
		    (public member function)
	  extension returns the	file extension path component
		    (public member function)

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

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

home | help