std::filesystem::directory_entry::assign - cppreference.com (original) (raw)
Assigns new content to the directory entry object. Sets the path to p and calls refresh to update the cached attributes. If an error occurs, the values of the cached attributes are unspecified.
This function does not commit any changes to the filesystem.
[edit] Parameters
| p | - | path to the filesystem object to which the directory entry will refer |
|---|---|---|
| ec | - | out-parameter for error reporting in the non-throwing overload |
[edit] Return value
(none)
[edit] Exceptions
Any overload not marked noexcept may throw std::bad_alloc if memory allocation fails.
Throws std::filesystem::filesystem_error on underlying OS API errors, constructed with p as the first path argument and the OS error code as the error code argument.
Sets a std::error_code& parameter to the OS API error code if an OS API call fails, and executes ec.clear() if no errors occur.
[edit] Example
Possible output:
The entry "/tmp" is a directory entry.assign(); The entry "/tmp/cppreference.html" is a regular file remove(entry); The entry "/tmp/cppreference.html" is a regular file entry.assign(); The entry "/tmp/cppreference.html" does not exists on the file system