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

FreeBSD Manual Pages

  
 
  

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

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

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

	  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
	  The  overload	 that  does  not  take	a error_code& parameter	throws
       filesystem_error	on
	  underlying OS	API errors, constructed	with from as the  first	 argu-
       ment, 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	a  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)

http://cppreference.com		  2022.07.31	 std::experi...copy_symlink(3)

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

home | help