std::filesystem::path::stem
From cppreference.com
< cpp | filesystem | path
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
std::filesystem::path
path::stem
(until C++20)(until C++20)(until C++20)(until C++20)(until C++20)(C++20)
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 filename().
[edit] Parameters
(none)
[edit] Return value
The stem of the filename identified by the path (i.e. the filename without the final extension).
[edit] Exceptions
May throw implementation-defined exceptions.
[edit] 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"