Linux Manuals session 3

std::filesystem::path::c_str,std::filesystem::path::native, – std::filesystem::path::c_str,std::filesystem::path::native, Synopsis const value_type *c_str() const noexcept; (1)(since C++ 17) const string_type &native() const noexcept; (2)(since C++ 17) operator string_type() const; (3)(since C++ 17) Accesses the native path name as a character string. 1) Equivalent to native().c_str(). 2) Returns the native-format representation of the pathname by reference. 3) Returns the native-format representation of the pathname by…

std::filesystem::path::begin,std::filesystem::path::end – std::filesystem::path::begin,std::filesystem::path::end Synopsis iterator begin() const; (1) (since C++17) iterator end() const; (2) (since C++17) 1) Returns an iterator to the first element of the path. If the path is empty, the returned iterator is equal to end(). 2) Returns an iterator one past the last element of the path. Dereferencing this iterator is…

std::filesystem::path::assign – std::filesystem::path::assign Synopsis path &assign(string_type &&source); (1)(since C++ 17) template <class Source> (2)(since C++ 17) path &assign(const Source &source); template <class InputIt> (3)(since C++ 17) path &assign(InputIt first, InputIt last); Replaces the contents to the path object by a new pathname constructed from the given character sequence. 1) Assigns the pathname identified by the…

std::filesystem::path – std::filesystem::path Synopsis Defined in header <filesystem> class path; (since C++17) Objects of type path represent paths on a filesystem. Only syntactic aspects of paths are handled: the pathname may represent a non-existing path or even one that is not allowed to exist on the current file system or OS. The path name has…

std::filesystem::last_write_time – std::filesystem::last_write_time Synopsis Defined in header<filesystem> std::filesystem::file_time_type last_write_time(const std::filesystem::path &p); std::filesystem::file_time_type last_write_time(const std::filesystem::path &p, (1)(since C++ 17) std::error_code &ec) noexcept; void last_write_time(const std::filesystem::path &p, std::filesystem::file_time_type new_time); void last_write_time(const std::filesystem::path &p, (2)(since C++ 17) std::filesystem::file_time_type new_time, std::error_code &ec) noexcept; 1) Returns the time of the last modification of p, determined as if by accessing the…

std::filesystem::is_symlink – std::filesystem::is_symlink Synopsis Defined in header<filesystem> bool is_symlink(std::filesystem::file_status s) noexcept; (1)(since C++ 17) bool is_symlink(const std::filesystem::path &p); (2)(since C++ 17) bool is_symlink(const std::filesystem::path &p, std::error_code &ec) noexcept; Checks if the given file status or path corresponds to a symbolic link, as if determined by the POSIX S_IFLNK. 1) Equivalent to s.type() == file_type::symlink. 2)…

std::filesystem::is_socket – std::filesystem::is_socket Synopsis Defined in header<filesystem> bool is_socket(std::filesystem::file_status s) noexcept; (1)(since C++ 17) bool is_socket(const std::filesystem::path &p); (2)(since C++ 17) bool is_socket(const std::filesystem::path &p, std::error_code &ec) noexcept; Checks if the given file status or path corresponds to a named IPC socket, as if determined by the POSIX S_IFSOCK. 1) Equivalent to s.type() == file_type::socket….

std::filesystem::is_regular_file – std::filesystem::is_regular_file Synopsis Defined in header<filesystem> bool is_regular_file(std::filesystem::file_status s) noexcept; (1)(since C++ 17) bool is_regular_file(const std::filesystem::path &p); (2)(since C++ 17) bool is_regular_file(const std::filesystem::path &p, std::error_code &ec) noexcept; Checks if the given file status or path corresponds to a regular file. 1) Equivalent to s.type() == file_type::regular. 2) Equivalent to is_regular_file(status(p)) or is_regular_file(status(p, ec)) respectively….

std::filesystem::is_other – std::filesystem::is_other Synopsis Defined in header<filesystem> bool is_other(std::filesystem::file_status s) noexcept; (1)(since C++ 17) bool is_other(const std::filesystem::path &p); (2)(since C++ 17) bool is_other(const std::filesystem::path &p, std::error_code &ec) noexcept; Checks if the given file status or path corresponds to a file of type other type. That is, the file exists, but is neither regular file, nor…

std::filesystem::is_fifo – std::filesystem::is_fifo Synopsis Defined in header<filesystem> bool is_fifo(std::filesystem::file_status s) noexcept; (1)(since C++ 17) bool is_fifo(const std::filesystem::path &p); (2)(since C++ 17) bool is_fifo(const std::filesystem::path &p, std::error_code &ec) noexcept; Checks if the given file status or path corresponds to a FIFO or pipe file as if determined by POSIX S_ISFIFO. 1) Equivalent to s.type() == file_type::fifo….

std::filesystem::is_empty – std::filesystem::is_empty Synopsis Defined in header<filesystem> bool is_empty(const std::filesystem::path &p); (since C++ 17) bool is_empty(const std::filesystem::path &p, std::error_code &ec); Checks whether the given path refers to an empty file or directory. Parameters p – path to examine ec – error code to modify in case of error Return value true if the file indicated…

std::filesystem::is_directory – std::filesystem::is_directory Synopsis Defined in header<filesystem> bool is_directory(std::filesystem::file_status s) noexcept; (1)(since C++ 17) bool is_directory(const std::filesystem::path &p); (2)(since C++ 17) bool is_directory(const std::filesystem::path &p, std::error_code &ec) noexcept; Checks if the given file status or path corresponds to a directory. 1) Equivalent to s.type() == file_type::directory. 2) Equivalent to is_directory(status(p)) or is_directory(status(p, ec)), respectively. Parameters…

std::filesystem::is_character_file – std::filesystem::is_character_file Synopsis Defined in header<filesystem> bool is_character_file(std::filesystem::file_status s) noexcept; (1)(since C++ 17) bool is_character_file(const std::filesystem::path &p); (2)(since C++ 17) bool is_character_file(const std::filesystem::path &p, std::error_code &ec) noexcept; Checks if the given file status or path corresponds to a character special file, as if determined by POSIX S_ISCHR. Examples of character special files are character…

std::filesystem::is_block_file – std::filesystem::is_block_file Synopsis Defined in header<filesystem> bool is_block_file(std::filesystem::file_status s) noexcept; (1)(since C++ 17) bool is_block_file(const std::filesystem::path &p); (2)(since C++ 17) bool is_block_file(const std::filesystem::path &p, std::error_code &ec) noexcept; Checks if the given file status or path corresponds to a block special file, as if determined by the POSIX S_ISBLK. Examples of block special files are…

std::filesystem::hash_value – std::filesystem::hash_value Synopsis Defined in header <filesystem> std::size_t hash_value( const path& p ) noexcept; (since C++17) Parameters p – a std::filesystem::path object Return value A hash value such that if for two paths, p1 == p2 then hash_value(p1) == hash_value(p2). Notes Equality of two paths is determined by comparing each component separately, so, for…

std::filesystem::hard_link_count – std::filesystem::hard_link_count Synopsis Defined in header<filesystem> std::uintmax_t hard_link_count(const std::filesystem::path &p); std::uintmax_t hard_link_count(const std::filesystem::path &p, (1)(since C++ 17) std::error_code &ec) noexcept; Returns the number of hard links for the filesystem object identified by path p. The non-throwing overload returns static_cast<uintmax_t>(-1) on errors. Parameters p – path to examine ec – out-parameter for error reporting in…

std::filesystem::filesystem_error::what – std::filesystem::filesystem_error::what Synopsis const char *what() const noexcept override; (since C++ 17) Returns an explanatory byte string. This explanatory string contains the explanatory string passed at the time of construction. Implementations are encouraged to include the pathnames of path1() and path2() in native format and the std::system_error::what() string inside the returned string as well….

std::filesystem::filesystem_error::path1,std::filesystem::filesystem_error::path2 – std::filesystem::filesystem_error::path1,std::filesystem::filesystem_error::path2 Synopsis const std::filesystem::path &path1() const noexcept; (since C++ 17) const std::filesystem::path &path2() const noexcept; (since C++ 17) Returns the paths that were stored in the exception object. Parameters (none) Example  This section is incomplete  Reason: no example

std::filesystem::filesystem_error::filesystem_error – std::filesystem::filesystem_error::filesystem_error Synopsis filesystem_error(const std::string &what_arg, (1)(since C++ 17) std::error_code ec); filesystem_error(const std::string &what_arg, const std::filesystem::path &p1, (2)(since C++ 17) std::error_code ec); filesystem_error(const std::string &what_arg, const std::filesystem::path &p1, (3)(since C++ 17) const std::filesystem::path &p2, std::error_code ec); Constructs a new filesystem error object. The error code is set to ec and optionally, the paths that…

std::filesystem::filesystem_error – std::filesystem::filesystem_error Synopsis Defined in header <filesystem> class filesystem_error; (since C++17) The class std::filesystem::filesystem_error defines an exception object that is thrown on failure by the throwing overloads of the functions in the filesystem library.  std-filesystem-filesystem error-inheritance.svg Inheritance diagram Member functions               constructs the error object constructor (public member function)               returns the paths that were involved…