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

NAME
     std::experimental::filesystem::copy_symlink  -  std::experimental::filesys-
     tem::copy_symlink

Synopsis
	Defined in header <experimental/filesystem>
	void copy_symlink( const path& from, const path& to );	(1)  (filesystem
     TS)
	void  copy_symlink(  const path& from, const path& to,	 (2) (filesystem
     TS)
			   error_code& ec );

	Copies a symlink to another location.

	1) Effectively calls f(read_symlink(from), to) where  f  is  create_sym-
     link() or
	create_directory_symlink depending on whether from resolves to a file or
     directory.
	2)  Effectively  calls f(read_symlink(from, ec), to, ec) where f is cre-
     ate_symlink()
	or create_directory_symlink depending on whether from resolves to a file
     or
	directory.

Parameters
	from - path to a symbolic link to copy
	to   - destination path of the new symlink
	ec   - out-parameter for error reporting in the non-throwing overload

Return value
	(none)

Exceptions
	The overload that does not take an error_code& parameter throws filesys-
     tem_error on
	underlying OS API errors, constructed with from as the	first  argument,
     to as the
	second	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  er-
     ror_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

See also
	copy			 copies files or directories
				 (function)
	copy_file		 copies file contents
				 (function)
	create_symlink		 creates a symbolic link
	create_directory_symlink (function)
	read_symlink		 obtains the target of a symbolic link
				 (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...copy_symlink(3)
home | help