29 Input/output library [input.output]

29.11 File systems [filesystems]

29.11.7 Class filesystem_­error [fs.class.filesystem.error]

29.11.7.2 Members [fs.filesystem.error.members]

1
#
Constructors are provided that store zero, one, or two paths associated with an error.
🔗
filesystem_error(const string& what_arg, error_code ec);
2
#
Postconditions:
  • (2.1)
    code() == ec,
  • (2.2)
    path1().empty() == true,
  • (2.3)
    path2().empty() == true, and
  • (2.4)
    string_­view(what()).find(what_­arg.c_­str()) != string_­view​::​npos.
🔗
filesystem_error(const string& what_arg, const path& p1, error_code ec);
3
#
Postconditions:
  • (3.1)
    code() == ec,
  • (3.2)
    path1() returns a reference to the stored copy of p1,
  • (3.3)
    path2().empty() == true, and
  • (3.4)
    string_­view(what()).find(what_­arg.c_­str()) != string_­view​::​npos.
🔗
filesystem_error(const string& what_arg, const path& p1, const path& p2, error_code ec);
4
#
Postconditions:
  • (4.1)
    code() == ec,
  • (4.2)
    path1() returns a reference to the stored copy of p1,
  • (4.3)
    path2() returns a reference to the stored copy of p2, and
  • (4.4)
    string_­view(what()).find(what_­arg.c_­str()) != string_­view​::​npos.
🔗
const path& path1() const noexcept;
5
#
Returns: A reference to the copy of p1 stored by the constructor, or, if none, an empty path.
🔗
const path& path2() const noexcept;
6
#
Returns: A reference to the copy of p2 stored by the constructor, or, if none, an empty path.
🔗
const char* what() const noexcept override;
7
#
Returns: An ntbs that incorporates the what_­arg argument supplied to the constructor.
The exact format is unspecified.
Implementations should include the system_­error​::​what() string and the pathnames of path1 and path2 in the native format in the returned string.