std::experimental::filesystem::path::replace_filename(3)

NAME
std::experimental::filesystem::path::replace_filename - std::experimental::filesystem::path::replace_filename

Synopsis
   path& replace_filename( const path& replacement ); (filesystem TS)
   Replaces a single filename component with replacement.
   Equivalent to the following:
 remove_filename();
 operator/=(replacement);
   The behavior is undefined if the path has no filename component (has_filename
   returns false).

Parameters
   (none)

Return value
   *this

Exceptions
   May throw implementation-defined exceptions.

Example
// Run this code
 #include <experimental/filesystem>
 #include <iostream>
 namespace fs = std::experimental::filesystem;
 int main()
 {
     std::cout << fs::path("/foo").replace_filename("bar") << '\n'
               << fs::path("/").replace_filename("bar") << '\n';
 }

Output:
 "/bar"
 "bar"

See also
   replace_extension replaces the extension
                     (public member function)
   filename returns the filename path component
                     (public member function)
   remove_filename removes filename path component
                     (public member function)
   has_filename checks if the corresponding path element is not empty
                     (public member function)

Category:
     * Noindexed pages