std::experimental::filesystem::path::extension

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Filesystem library

Template:cpp/experimental/fs/navbar content

 

path

Template:cpp/experimental/fs/path/navbar content

 

path extension() const;		(filesystem TS)

Returns the extension of the filename() identified by the path.

The extension is the substring between the last . character and the end of the filename. The return value of the function returns the . character if an extension is present.

If the pathname is either . or .., or the pathname does not contain the . character, then empty path is returned.

Additional behavior may be defined by the implementations for file systems which append additional elements (such as alternate data streams or partitioned dataset names) to extensions.

Parameters

(none)

Return value

The extension of the current pathname or an empty path if there's no extension.

Exceptions

(none)

Example

Run this code

#include <filesystem>
#include <iostream>
 
int main()
{
    std::cout << std::fs::path("/foo/bar.txt").extension() << '\n';
    std::cout << std::fs::path("/foo/bar.").extension() << '\n';
    std::cout << std::fs::path("/foo/bar").extension() << '\n';
    std::cout << std::fs::path("/foo/bar.txt/bar.cc").extension() << '\n';
    std::cout << std::fs::path("/foo/bar.txt/bar.").extension() << '\n';
    std::cout << std::fs::path("/foo/bar.txt/bar").extension() << '\n';
    std::cout << std::fs::path("/foo/.").extension() << '\n';
    std::cout << std::fs::path("/foo/..").extension() << '\n';
    std::cout << std::fs::path("/foo/.hidden").extension() << '\n';
}

Output:

.txt
.
 
.cc
.
 
 
 
.hidden

See also

filename	returns the filename path component (public member function)
stem	returns the stem path component (public member function)