Namespaces
Variants
Views
Actions

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

From cppreference.com
< cpp‎ | experimental‎ | fs‎ | path
 
 
Technical specifications
Filesystem library (filesystem TS)
Library fundamentals (library fundamentals TS)
Library fundamentals 2 (library fundamentals TS v2)
Library fundamentals 3 (library fundamentals TS v3)
Extensions for parallelism (parallelism TS)
Extensions for parallelism 2 (parallelism TS v2)
Extensions for concurrency (concurrency TS)
Concepts (concepts TS)
Ranges (ranges TS)
Mathematical special functions (special functions TR)
 
 
 
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).

Contents

[edit] Parameters

(none)

[edit] Return value

*this

[edit] Exceptions

(none)

[edit] Example

#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"

[edit] See also

replaces the extension
(public member function) [edit]
returns the filename path component
(public member function) [edit]
removes filename path component
(public member function) [edit]
checks if the corresponding path element is not empty
(public member function)