lib/File/Copy.pm

17 sub copy;
31 @EXPORT = qw(copy move);
58 sub copy {
59     croak("Usage: copy(FROM, TO [, BUFFERSIZE]) ")
136 	croak("Bad buffer size for copy: $size\n") unless ($size > 0);
204     return 1 if copy($from,$to) && unlink($from);
213 *cp = \&copy;
257 	*syscopy = \&copy;
273 	copy("file1","file2") or die "Copy failed: $!";
274 	copy("Copy.pm",\*STDOUT);
285 The File::Copy module provides two basic functions, C<copy> and
293 The C<copy> function takes two
294 parameters: a file to copy from and a file to copy to. Either
299 written to (and created if need be).  Trying to copy a file on top
329 during this copy-and-delete process, you may be left with a (possibly partial)
330 copy of the file under the destination name.
333 you may use the "cp" alias for C<copy>.
341 C<copy> routine, which doesn't preserve OS-specific attributes.  For
351 If both arguments to C<copy> are not file handles,
352 then C<copy> will perform a "system copy" of
355 parameter is ignored.  If either argument to C<copy> is a
360 The system copy routine may also be called directly under VMS and OS/2
398 Like C<copy>, C<rmscopy> returns 1 on success.  If an error occurs,
422   copy("file1", "tmp");        # creates the file 'tmp' in the current directory
423   copy("file1", ":tmp:");      # creates :tmp:file1
424   copy("file1", ":tmp");       # same as above
425   copy("file1", "tmp");        # same as above, if 'tmp' is a directory (but don't do
427   copy("file1", "tmp:file1");  # error, since 'tmp:' is not a volume
428   copy("file1", ":tmp:file1"); # ok, partial path
429   copy("file1", "DataHD:");    # creates DataHD:file1