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  ex-
     ist 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 filesys-
     tem_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&  parameter
     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 environment
     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	GetTemp-
     Path.

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)
home | help