filesystem_error Class

A base class for all exceptions that report a low-level system error.

Syntax

class filesystem_error : public system_error;

Remarks

This class serves as the base class for all exceptions that report an error in <filesystem> functions. It stores a string object, called mymesg in this article for clarity. It also stores two path objects, called mypval1 and mypval2.

Members

Constructors

Functions

Requirements

Header: <filesystem>

Namespace: std::filesystem

filesystem_error

The first constructor builds its message from what_arg and ec. The second constructor also builds its message from pval1, which it stores in mypval1. The third constructor also builds its message from pval1, which it stores in mypval1, and from pval2, which it stores in mypval2.

filesystem_error(const string& what_arg,
    error_code ec);

filesystem_error(const string& what_arg,
    const path& pval1,
    error_code ec);

filesystem_error(const string& what_arg,
    const path& pval1,
    const path& pval2,
    error_code ec);

Parameters

what_arg
Specified message.

ec
Specified error code.

mypval1
Further specified message parameter.

mypval2
Further specified message parameter.

path1

The member function returns mypval1

const path& path1() const noexcept;

path2

The member function returns mypval2

const path& path2() const noexcept;

what

The member function returns a pointer to an NTBS, preferably composed from runtime_error::what(), system_error::what(), mymesg, mypval1.native_string(), and mypval2.native_string().

const char *what() const noexcept;