Linux Manuals session 3

std::filesystem::recursive_directory_iterator::recursion_pending – std::filesystem::recursive_directory_iterator::recursion_pending Synopsis bool recursion_pending() const; (since C++17) Returns true if the next increment will cause the directory currently referred to by *this to be iterated into. This function returns true immediately after construction or an increment. Recursion can be disabled via disable_recursion_pending(). Parameters (none) Return value true if the next increment will iterate…

std::filesystem::recursive_directory_iterator::pop – std::filesystem::recursive_directory_iterator::pop Synopsis void pop(); (1)(since C++ 17) void pop(std::error_code &ec); (2)(since C++ 17) Moves the iterator one level up in the directory hierarchy. Invalidates all copies of the previous value of *this. If the parent directory is outside directory hierarchy that is iterated on (i.e. depth() == 0), sets *this to an end…

std::filesystem::recursive_directory_iterator::options – std::filesystem::recursive_directory_iterator::options Synopsis directory_options options() const; (since C++17) Returns the options that affect the directory iteration. The options can only be supplied when constructing the directory iterator. If the options argument was not supplied, returns options::none. Parameters (none) Return value The effective options that affect the directory iteration. Exceptions (none)

std::filesystem::recursive_directory_iterator::operator= – std::filesystem::recursive_directory_iterator::operator= Synopsis recursive_directory_iterator &operator=(const recursive_directory_iterator &other) = default; (since C++ 17) recursive_directory_iterator & operator=(recursive_directory_iterator &&other) = default; (since C++ 17) Assigns a recursive directory iterator. Parameters other – another directory iterator to assign Return value *this Exceptions (none)  This section is incomplete

std::filesystem::recursive_directory_iterator::operator*,std::filesystem::recursive_directory_iterator::operator-> – std::filesystem::recursive_directory_iterator::operator*,std::filesystem::recursive_directory_iterator::operator-> Synopsis const std::filesystem::directory_entry &operator*() const; (1)(since C++ 17) const std::filesystem::directory_entry * operator->() const; (2)(since C++ 17) Accesses the pointed-to directory_entry The result of operator* or operator-> on the end iterator is undefined behavior. Parameters (none) Return value 1) Value of the directory_entry referred to by this iterator 2) Pointer to the directory_entry…

std::filesystem::recursive_directory_iterator::disable_recursion_pending – std::filesystem::recursive_directory_iterator::disable_recursion_pending Synopsis void disable_recursion_pending(); (since C++ 17) Disables recursion to the currently referred subdirectory, if any. The call modifies the pending recursion flag on the iterator in such a way that the next time increment is called, the iterator will advance within the current directly even if it is currently referring to a…

std::filesystem::recursive_directory_iterator::depth – std::filesystem::recursive_directory_iterator::depth Synopsis int depth() const; (since C++ 17) Returns the number of directories from the starting directory to the currently iterated directory, i.e. the current depth of the directory hierarchy. The starting directory has depth of 0, its subdirectories have depth 1, etc. The behavior is undefined if *this is the end iterator….

std::filesystem::recursive_directory_iterator – std::filesystem::recursive_directory_iterator Synopsis Defined in header <filesystem> class recursive_directory_iterator; (since C++17) recursive_directory_iterator is an LegacyInputIterator that iterates over the directory_entry elements of a directory, and, recursively, over the entries of all subdirectories. The iteration order is unspecified, except that each directory entry is visited only once. By default, symlinks are not followed, but this…

std::filesystem::read_symlink – std::filesystem::read_symlink Synopsis Defined in header<filesystem> std::filesystem::path read_symlink(const std::filesystem::path &p); std::filesystem::path read_symlink(const std::filesystem::path &p, (since C++ 17) std::error_code &ec); If the path p refers to a symbolic link, returns a new path object which refers to the target of that symbolic link. It is an error if p does not refer to a symbolic…

std::filesystem::perms – std::filesystem::perms Synopsis Defined in header <filesystem> enum class perms; (since C++17) This type represents file access permissions. perms satisfies the requirements of BitmaskType (which means the bitwise operators operator&, operator|, operator^, operator~, operator&=, operator|=, and operator^= are defined for this type) Access permissions model POSIX_permission_bits, and any individual file permissions (as reported by…

std::filesystem::permissions – std::filesystem::permissions Synopsis Defined in header<filesystem> void permissions(const std::filesystem::path &p, std::filesystem::perms prms, std::filesystem::perm_options opts = perm_options::replace); void permissions(const std::filesystem::path &p, std::filesystem::perms prms, (since C++ 17) std::error_code &ec) noexcept; void permissions(const std::filesystem::path &p, std::filesystem::perms prms, std::filesystem::perm_options opts, std::error_code &ec); Changes access permissions of the file to which p resolves, as if by POSIX fchmodat. Symlinks…

std::filesystem::perm_options – std::filesystem::perm_options Synopsis Defined in header <filesystem> enum class perm_options { replace = /* unspecified */, add = /* unspecified */, (since C++17) remove = /* unspecified */, nofollow = /* unspecified */ }; This type represents available options that control the behavior of the function permissions(). perm_options satisfies the requirements of BitmaskType (which…

std::filesystem::path::swap – std::filesystem::path::swap Synopsis void swap(path &other) noexcept; (1)(since C++ 17) Swaps the contents (both native and generic format) of *this and other. Parameters other – another path to exchange the contents with Return value (none) Complexity Constant. See also                             swaps two paths swap(std::filesystem::path) (function)

std::filesystem::path::string,std::filesystem::path::wstring,std::filesystem::path::u8string,std::filesystem::path::u16string,std::filesystem::path::u32string – std::filesystem::path::string,std::filesystem::path::wstring,std::filesystem::path::u8string,std::filesystem::path::u16string,std::filesystem::path::u32string Synopsis template <class CharT, class Traits = std::char_traits<CharT>, class Alloc = std::allocator<CharT>> (1)(since C++ 17) std::basic_string<CharT, Traits, Alloc> string(const Alloc &a = Alloc()) const; std::string string() const; std::wstring wstring() const; std::u16string u16string() const; std::u32string u32string() const; (2)(since C++ 17) std::string u8string() const; (since C++ 17)(3)(until C++ 20) std::u8string u8string() const; (since C++…

std::filesystem::path::string,std::filesystem::path::wstring, – std::filesystem::path::string,std::filesystem::path::wstring, Synopsis                     std::filesystem::path::u32string template <class CharT, class Traits = std::char_traits<CharT>, (since class Alloc = std::allocator<CharT> > (1)C++ 17) std::basic_string<CharT, Traits, Alloc> string(const Alloc &a = Alloc()) const; std::string string() const; std::wstring wstring() const; std::u16string u16string() const; std::u32string u32string() const; (2)(since(since std::string u8string() const; C++ 17) C++ 17)(3)(until C++ 20) std::u8string u8string() const; (since…

std::filesystem::path::stem – std::filesystem::path::stem Synopsis path stem() const; (since C++17) Returns the filename identified by the generic-format path stripped of its extension. Returns the substring from the beginning of filename() up to and not including the last period (.) character, with the following exceptions: If the first character in the filename is a period, that period…

std::filesystem::path::root_path – std::filesystem::path::root_path Synopsis path root_path() const; (since C++17) Returns the root path of the path. If the path does not include root path, returns path(). Effectively, returns the following: root_name() / root_directory() Parameters (none) Return value The root path of the path. Exceptions (none) Example // Run this code #include <iostream> #include <filesystem> namespace…

std::filesystem::path::root_name – std::filesystem::path::root_name Synopsis path root_name() const; (since C++17) Returns the root name of the generic-format path. If the path (in generic format) does not include root name, returns path(). Parameters (none) Return value The root name of the path. Exceptions (none) Example // Run this code #include <iostream> #include <filesystem> namespace fs = std::filesystem;…

std::filesystem::path::root_directory – std::filesystem::path::root_directory Synopsis path root_directory() const; (since C++17) Returns the root directory of the generic-format path. If the path (in generic format) does not include root directory, returns path(). Parameters (none) Return value The root directory of the path. Exceptions (none) Example // Run this code #include <iostream> #include <filesystem> namespace fs = std::filesystem;…

std::filesystem::path::replace_filename – std::filesystem::path::replace_filename Synopsis path& replace_filename( const path& replacement ); (since C++17) Replaces a single filename component with replacement. Equivalent to the following: remove_filename(); operator/=(replacement); The behavior is undefined if the path has no filename component (has_filename returns false). Parameters (none) Return value *this Exceptions (none) Example // Run this code #include <iostream> #include <filesystem>…