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

FreeBSD Manual Pages

  
 
  

home | help 
std::filesy...copy_symlink(3) C++ Standard Libarystd::filesy...copy_symlink(3)

NAME
       std::filesystem::copy_symlink - std::filesystem::copy_symlink

Synopsis
	  Defined in header <filesystem>
	  void	copy_symlink(  const  std::filesystem::path&  from, (1)	(since
       C++17)
			     const std::filesystem::path& to);
	  void copy_symlink( const std::filesystem::path& from,

			     const  std::filesystem::path&  to,	   (2)	(since
       C++17)

			     std::error_code& ec ) noexcept;

	  Copies a symlink to another location.

	  1)  Effectively  calls  f(read_symlink(from),	 to)  where  f is cre-
       ate_symlink 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
       create_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 over-
       load

Return value
	  (none)

Exceptions
	  Any overload not marked noexcept may throw std::bad_alloc if	memory
       allocation
	  fails.

	  1) Throws std::filesystem::filesystem_error on underlying OS API er-
       rors, constructed
	  with	from  as  the first path argument, to as the second path argu-
       ment, and the OS
	  error	code as	the error code argument.
	  2) Sets a std::error_code& parameter to the OS API error code	if  an
       OS API call
	  fails, and executes ec.clear() if no errors occur.

Example
	   This	section	is incomplete
	   Reason: no example

See also
	  copy			   copies files	or directories
	  (C++17)		   (function)
	  copy_file		   copies file contents
	  (C++17)		   (function)
	  create_symlink
	  create_directory_symlink creates a symbolic link
	  (C++17)		   (function)
	  (C++17)
	  read_symlink		   obtains the target of a symbolic link
	  (C++17)		   (function)

Category:
	    * Todo no example

http://cppreference.com		  2024.06.10	 std::filesy...copy_symlink(3)

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

home | help