Section 3: library functions
std::filesystem::copy_options – std::filesystem::copy_options Synopsis Defined in header <filesystem> enum class copy_options { none = /* unspecified */, skip_existing = /* unspecified */, overwrite_existing = /* unspecified */, update_existing = /* unspecified */, recursive = /* unspecified */, (since C++17) copy_symlinks = /* unspecified */, skip_symlinks = /* unspecified */, directories_only = /* unspecified */, create_symlinks…
std::filesystem::copy_file – std::filesystem::copy_file Synopsis Defined in header<filesystem> bool copy_file(const std::filesystem::path &from, const std::filesystem::path &to); bool copy_file(const std::filesystem::path &from, (1)(since C++ 17) const std::filesystem::path &to, std::error_code &ec); bool copy_file(const std::filesystem::path &from, const std::filesystem::path &to, std::filesystem::copy_options options); bool copy_file(const std::filesystem::path &from, (2)(since C++ 17) const std::filesystem::path &to, std::filesystem::copy_options options, std::error_code &ec); 1) The default, equivalent to (2)…
std::filesystem::copy – std::filesystem::copy Synopsis Defined in header<filesystem> void copy(const std::filesystem::path &from, const std::filesystem::path &to); void copy(const std::filesystem::path &from, (1)(since C++ 17) const std::filesystem::path &to, std::error_code &ec); void copy(const std::filesystem::path &from, const std::filesystem::path &to, std::filesystem::copy_options options); void copy(const std::filesystem::path &from, (2)(since C++ 17) const std::filesystem::path &to, std::filesystem::copy_options options, std::error_code &ec); Copies files and directories, with a…
std::filesystem::canonical,std::filesystem::weakly_canonical – std::filesystem::canonical,std::filesystem::weakly_canonical Synopsis Defined in header<filesystem> path canonical(const std::filesystem::path &p); (1)(since C++ 17) path canonical(const std::filesystem::path &p, (2)(since C++ 17) std::error_code &ec); path weakly_canonical(const std::filesystem::path &p); (3)(since C++ 17) path weakly_canonical(const std::filesystem::path &p, (4)(since C++ 17) std::error_code &ec); 1-2) Converts path p to a canonical absolute path, i.e. an absolute path that has no…
std::filesystem::begin(recursive_directory_iterator),std::filesystem::end(recursive_directory_iterator) – std::filesystem::begin(recursive_directory_iterator),std::filesystem::end(recursive_directory_iterator) Synopsis recursive_directory_iterator begin( recursive_directory_iterator iter ) noexcept; (1) (since C++17) recursive_directory_iterator end( const recursive_directory_iterator& ) noexcept; (2) (since C++17) 1) Returns iter unchanged 2) Returns a default-constructed recursive_directory_iterator, which serves as the end iterator. The argument is ignored. These non-member functions enable the use of recursive_directory_iterators with range-based for loops. Parameters iter…
std::filesystem::begin(directory_iterator),std::filesystem::end(directory_iterator) – std::filesystem::begin(directory_iterator),std::filesystem::end(directory_iterator) Synopsis directory_iterator begin( directory_iterator iter ) noexcept; (1) (since C++17) directory_iterator end( const directory_iterator& ) noexcept; (2) (since C++17) 1) Returns iter unchanged 2) Returns a default-constructed directory_iterator, which serves as the end iterator. The argument is ignored. These non-member functions enable the use of directory_iterators with range-based for loops. Parameters iter…
std::filesystem::absolute – std::filesystem::absolute Synopsis Defined in header<filesystem> path absolute(const std::filesystem::path &p); (since C++ 17) path absolute(const std::filesystem::path &p, std::error_code &ec); Returns a path referencing the same file system location as p, for which is_absolute() is true. The non-throwing overload returns default-constructed path if an error occurs. Parameters p – path to convert to absolute form…
std::basic_filebuf – std::basic_filebuf Synopsis Defined in header <fstream> template< class CharT, class Traits = std::char_traits<CharT> > class basic_filebuf : public std::basic_streambuf<CharT, Traits> std::basic_filebuf is a std::basic_streambuf whose associated character sequence is a file. Both the input sequence and the output sequence are associated with the same file, and a joint file position is maintained for…
std::fgetws – std::fgetws Synopsis Defined in header<cwchar> wchar_t *fgetws(wchar_t *str, int count, std::FILE *stream); Reads at most count – 1 wide characters from the given file stream and stores them in str. The produced wide string is always null-terminated. Parsing stops if end-of-file occurs or a newline wide character is found, in which case str…
std::fgetwc – std::fgetwc Synopsis Defined in header <cwchar> wint_t fgetwc( std::FILE* stream ); wint_t getwc( std::FILE* stream ); Reads the next wide character from the given input stream. getwc() may be implemented as a macro and may evaluate stream more than once. Parameters stream – to read the wide character from Return value The next…
std::fgets – std::fgets Synopsis Defined in header<cstdio> char *fgets(char *str, int count, std::FILE *stream); Reads at most count – 1 characters from the given file stream and stores them in the character array pointed to by str. Reading stops if end-of-file occurs or a newline character is found, in which case str will contain that…
std::fgetpos – std::fgetpos Synopsis Defined in header<cstdio> int fgetpos(std::FILE *stream, std::fpos_t *pos); Obtains the file position indicator and the current parse state (if any) for the file stream stream and stores them in the object pointed to by pos. The value stored is only meaningful as the input to std::fsetpos. Parameters stream – file stream…
std::fgetc,std::getc – std::fgetc,std::getc Synopsis Defined in header<cstdio> int fgetc(std::FILE *stream); int getc(std::FILE *stream); Reads the next character from the given input stream. Parameters stream – to read the character from Return value The obtained character on success or EOF on failure. If the failure has been caused by end of file condition, additionally sets the…
std::fflush – std::fflush Synopsis Defined in header<cstdio> int fflush(std::FILE *stream); For output streams (and for update streams on which the last operation was output), writes any unwritten data from the stream’s buffer to the associated output device. For input streams (and for update streams on which the last operation was input), the behavior is undefined….
std::feupdateenv – std::feupdateenv Synopsis Defined in header <cfenv> int feupdateenv( const std::fenv_t* envp ) (since C++11) First, remembers the currently raised floating-point exceptions, then restores the floating-point environment from the object pointed to by envp (similar to std::fesetenv), then raises the floating-point exceptions that were saved. This function may be used to end the non-stop…
std::fetestexcept – std::fetestexcept Synopsis Defined in header <cfenv> int fetestexcept( int excepts ); (since C++11) Determines which of the specified subset of the floating point exceptions are currently set. The argument excepts is a bitwise OR of the floating_point_exception_macros. Parameters excepts – bitmask listing the exception flags to test Return value Bitwise OR of the…
std::ferror – std::ferror Synopsis Defined in header<cstdio> int ferror(std::FILE *stream); Checks the given stream for errors. Parameters stream – the file stream to check Return value Nonzero value if the file stream has errors occurred, 0 otherwise Example // Run this code #include <cstdio> #include <cstdlib> #include <clocale> #include <cwchar> int main(void) { const char…
std::feraiseexcept – std::feraiseexcept Synopsis Defined in header <cfenv> int feraiseexcept( int excepts ); (since C++11) Attempts to raise all floating point exceptions listed in excepts (a bitwise OR of the floating_point_exception_macros). If one of the exceptions is FE_OVERFLOW or FE_UNDERFLOW, this function may additionally raise FE_INEXACT. The order in which the exceptions are raised is…
std::feof – std::feof Synopsis Defined in header<cstdio> int feof(std::FILE *stream); Checks if the end of the given file stream has been reached. Parameters stream – the file stream to check Return value Nonzero value if the end of the stream has been reached, otherwise 0. Notes This function only reports the stream state as reported…
std::feholdexcept – std::feholdexcept Synopsis Defined in header <cfenv> int feholdexcept( std::fenv_t* envp ) (since C++11) First, saves the current floating-point environment to the object pointed to by envp (similar to std::fegetenv), then clears all floating-point status flags, and then installs the non-stop mode: future floating-point exceptions will not interrupt execution (will not trap), until the…