Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
std::filesy...ectory_path(3)  C++ Standard Libary std::filesy...ectory_path(3)

NAME
       std::filesystem::temp_directory_path   -	  std::filesystem::temp_direc-
       tory_path

Synopsis
	  Defined in header <filesystem>
	  path temp_directory_path();			   (1) (since C++17)
	  path temp_directory_path( std::error_code& ec	);

	  Returns the directory	location suitable for temporary	files.

Parameters
	  (none)

Return value
	  A directory suitable for temporary files. The	path is	guaranteed  to
       exist and to be
	  a directory. The overload that takes error_code& argument returns an
       empty path on
	  error.

Exceptions
	  The overload that does not take a std::error_code& parameter throws
	  filesystem::filesystem_error	on  underlying	OS  API	 errors,  con-
       structed	with path to
	  be returned as the first path	argument and the OS error code as  the
       error code
	  argument.  The  overload taking a std::error_code& parameter sets it
       to the OS API
	  error	code if	an OS API call fails, and executes  ec.clear()	if  no
       errors occur. Any
	  overload  not	marked noexcept	may throw std::bad_alloc if memory al-
       location	fails.

Notes
	  On POSIX systems, the	path may be the	one specified in the  environ-
       ment variables
	  TMPDIR,  TMP,	TEMP, TEMPDIR, and, if none of them are	specified, the
       path "/tmp" is
	  returned.

	  On Windows systems, the path is typically the	one returned  by  Get-
       TempPath

Example
       // Run this code

	#include <iostream>
	#include <filesystem>
	namespace fs = std::filesystem;
	int main()
	{
	    std::cout  << "Temp	directory is " << fs::temp_directory_path() <<
       '\n';
	}

Possible output:
	Temp directory is "C:\Windows\TEMP\"

See also
	  tmpfile      creates and opens a temporary, auto-removing file
		       (function)
	  current_path returns or sets the current working directory
	  (C++17)      (function)

http://cppreference.com		  2022.07.31	  std::filesy...ectory_path(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::filesystem::temp_directory_path&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help