Linux Manuals session 3

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>…

std::filesystem::path::replace_extension – std::filesystem::path::replace_extension Synopsis path &replace_extension(const path &replacement = path()); (1)(since C++ 17) Replaces the extension with replacement or removes it when the default value of replacement is used. Firstly, if this path has an extension(), it is removed from the generic – format view of the pathname. Then, a dot character is appended to…

std::filesystem::path::remove_filename – std::filesystem::path::remove_filename Synopsis path& remove_filename() (1) (since C++17) Removes a single generic-format filename component (as returned by filename) from the given generic-format path. After this function completes, has_filename returns false. Parameters (none) Return value *this Exceptions (none) Example // Run this code #include <iostream> #include <filesystem> namespace fs = std::filesystem; int main() { std::cout…

std::filesystem::path::relative_path – std::filesystem::path::relative_path Synopsis path relative_path() const; (since C++17) Returns path relative to root-path, that is, a pathname composed of every generic-format component of *this after root-path. If *this is an empty path, returns an empty path. Parameters (none) Return value Path relative to the root_path. Exceptions (none) Examples // Run this code #include <iostream>…

std::filesystem::path::~path – std::filesystem::path::~path Synopsis ~path(); (since C++17) Destroys the path object.

std::filesystem::path::parent_path – std::filesystem::path::parent_path Synopsis path parent_path() const; (since C++17) Returns the path to the parent directory. If has_relative_path() returns false, the result is a copy of *this Otherwise, the result is a path whose generic format pathname is the longest prefix of the generic format pathname of *this that produces one fewer element in its…