std::experimental::filesystem::path::replace_filename (3) - Linux Manuals

std::experimental::filesystem::path::replace_filename: std::experimental::filesystem::path::replace_filename

Command to display std::experimental::filesystem::path::replace_filename manual in Linux: $ man 3 std::experimental::filesystem::path::replace_filename

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

(none)

Example

// Run this code

  #include <iostream>
  #include <experimental/filesystem>
  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"