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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::experimental::filesystem::temp_directory_path   -  std::experimen-
       tal::filesystem::temp_directory_path

Synopsis
	  Defined in header <experimental/filesystem>
	  path temp_directory_path();		      (1) (filesystem TS)
	  path temp_directory_path( 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 an error_code& parameter	throws
       filesystem_error	on
	  underlying OS	API errors, constructed	with path to  be  returned  as
       the first argument
	  and the OS error code	as the error code argument. std::bad_alloc may
       be thrown if
	  memory  allocation fails. The	overload taking	an error_code& parame-
       ter sets	it to the
	  OS API error code if an OS API call fails, and  executes  ec.clear()
       if no errors
	  occur. This overload has
	  noexcept specification:
	  noexcept

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 <experimental/filesystem>
	#include <iostream>
	namespace fs = std::experimental::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)

Categories:
	    * Noindexed	pages
	    * unconditionally noexcept

Hidden categories:
	    * Pages with unreviewed unconditional noexcept template
	    * Pages with unreviewed noexcept template

http://cppreference.com		  2024.06.10	  std::experi...ectory_path(3)

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

home | help