# package has not yet been updated to work with Perl 5.004, and so it
# would be a Bad Thing for the CPAN module to grab it and replace this
# module. Therefore, we set this module's version higher than 2.0.
-$VERSION = '2.09';
+$VERSION = '2.10';
require Exporter;
@ISA = qw(Exporter);
return File::Spec->catfile($to, basename($from));
}
+# _eq($from, $to) tells whether $from and $to are identical
+# works for strings and references
+sub _eq {
+ return $_[0] == $_[1] if ref $_[0] && ref $_[1];
+ return $_[0] eq $_[1] if !ref $_[0] && !ref $_[1];
+ return "";
+}
+
sub copy {
croak("Usage: copy(FROM, TO [, BUFFERSIZE]) ")
unless(@_ == 2 || @_ == 3);
|| UNIVERSAL::isa($to, 'IO::Handle'))
: (ref(\$to) eq 'GLOB'));
- if ($from eq $to) { # works for references, too
+ if (_eq($from, $to)) { # works for references, too
carp("'$from' and '$to' are identical (not copied)");
# The "copy" was a success as the source and destination contain
# the same data.
# preserve MPE file attributes.
return system('/bin/cp', '-f', $_[0], $_[1]) == 0;
};
- } elsif ($^O eq 'MSWin32') {
+ } elsif ($^O eq 'MSWin32' && defined &DynaLoader::boot_DynaLoader) {
+ # Win32::CopyFile() fill only work if we can load Win32.xs
*syscopy = sub {
return 0 unless @_ == 2;
return Win32::CopyFile(@_, 1);
=over 4
-=item *
+=item copy
+X<copy> X<cp>
The C<copy> function takes two
parameters: a file to copy from and a file to copy to. Either
An optional third parameter can be used to specify the buffer
size used for copying. This is the number of bytes from the
-first file, that wil be held in memory at any given time, before
+first file, that will be held in memory at any given time, before
being written to the second file. The default buffer size depends
upon the file, but will generally be the whole file (up to 2Mb), or
1k for filehandles that do not reference files (eg. sockets).
You may use the syntax C<use File::Copy "cp"> to get at the
"cp" alias for this function. The syntax is I<exactly> the same.
-=item *
+=item move
+X<move> X<mv> X<rename>
The C<move> function also takes two parameters: the current name
and the intended name of the file to be moved. If the destination
You may use the "mv" alias for this function in the same way that
you may use the "cp" alias for C<copy>.
-=back
+=item syscopy
+X<syscopy>
File::Copy also provides the C<syscopy> routine, which copies the
file specified in the first parameter to the file specified in the
On Mac OS (Classic), C<syscopy> calls C<Mac::MoreFiles::FSpFileCopy>,
if available.
-=head2 Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
+B<Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)>
If both arguments to C<copy> are not file handles,
then C<copy> will perform a "system copy" of
as C<File::Copy::syscopy> (or under VMS as C<File::Copy::rmscopy>, which
is the routine that does the actual work for syscopy).
-=over 4
-
=item rmscopy($from,$to[,$date_flag])
+X<rmscopy>
The first and second arguments may be strings, typeglobs, typeglob
references, or objects inheriting from IO::Handle;
copy("file1", "tmp"); # creates the file 'tmp' in the current directory
copy("file1", ":tmp:"); # creates :tmp:file1
copy("file1", ":tmp"); # same as above
- copy("file1", "tmp"); # same as above, if 'tmp' is a directory (but don't do
+ copy("file1", "tmp"); # same as above, if 'tmp' is a directory (but don't do
# that, since it may cause confusion, see example #1)
copy("file1", "tmp:file1"); # error, since 'tmp:' is not a volume
copy("file1", ":tmp:file1"); # ok, partial path
copy("file1", "DataHD:"); # creates DataHD:file1
-
- move("MacintoshHD:fileA", "DataHD:fileB"); # moves (don't copies) files from one
+
+ move("MacintoshHD:fileA", "DataHD:fileB"); # moves (don't copies) files from one
# volume to another
=back
#!./perl
BEGIN {
- chdir 't' if -d 't';
- @INC = '../lib';
+ if( $ENV{PERL_CORE} ) {
+ chdir 't' if -d 't';
+ @INC = '../lib';
+ }
}
use Test::More;
)
{
eval $code;
- like $@, qr/^Usage: /;
+ like $@, qr/^Usage: /, "'$code' is a usage error";
}
$foo = <F>;
close(F);
- is -s "file-$$", -s "copy-$$";
+ is -s "file-$$", -s "copy-$$", 'copy(fn, fn): files of the same size';
- is $foo, "ok\n";
+ is $foo, "ok\n", 'copy(fn, fn): same contents';
+ print("# next test checks copying to STDOUT\n");
binmode STDOUT unless $^O eq 'VMS'; # Copy::copy works in binary mode
# This outputs "ok" so its a test.
copy "copy-$$", \*STDOUT;
open(F,"file-$$");
copy(*F, "copy-$$");
open(R, "copy-$$") or die "open copy-$$: $!"; $foo = <R>; close(R);
- is $foo, "ok\n";
+ is $foo, "ok\n", 'copy(*F, fn): same contents';
unlink "copy-$$" or die "unlink: $!";
open(F,"file-$$");
copy(\*F, "copy-$$");
close(F) or die "close: $!";
open(R, "copy-$$") or die; $foo = <R>; close(R) or die "close: $!";
- is $foo, "ok\n";
+ is $foo, "ok\n", 'copy(\*F, fn): same contents';
unlink "copy-$$" or die "unlink: $!";
require IO::File;
copy("file-$$",$fh);
$fh->close or die "close: $!";
open(R, "copy-$$") or die; $foo = <R>; close(R);
- is $foo, "ok\n";
+ is $foo, "ok\n", 'copy(fn, io): same contents';
unlink "copy-$$" or die "unlink: $!";
require FileHandle;
copy("file-$$",$fh);
$fh->close;
open(R, "copy-$$") or die; $foo = <R>; close(R);
- is $foo, "ok\n";
+ is $foo, "ok\n", 'copy(fn, fh): same contents';
unlink "file-$$" or die "unlink: $!";
ok !move("file-$$", "copy-$$"), "move on missing file";
ok -e "file-$$", ' destination exists';
ok !-e "copy-$$", ' source does not';
open(R, "file-$$") or die; $foo = <R>; close(R);
- is $foo, "ok\n";
+ is $foo, "ok\n", 'contents preserved';
TODO: {
local $TODO = 'mtime only preserved on ODS-5 with POSIX dates and DECC$EFS_FILE_TIMESTAMPS enabled' if $^O eq 'VMS';
($cross_partition_test ? " while testing cross-partition" : "");
}
+ # trick: create lib/ if not exists - not needed in Perl core
+ unless (-d 'lib') { mkdir 'lib' or die; }
copy "file-$$", "lib";
- open(R, "lib/file-$$") or die; $foo = <R>; close(R);
- is $foo, "ok\n";
+ open(R, "lib/file-$$") or die $!; $foo = <R>; close(R);
+ is $foo, "ok\n", 'copy(fn, dir): same contents';
unlink "lib/file-$$" or die "unlink: $!";
# Do it twice to ensure copying over the same file works.
copy "file-$$", "lib";
open(R, "lib/file-$$") or die; $foo = <R>; close(R);
- is $foo, "ok\n";
+ is $foo, "ok\n", 'copy over the same file works';
unlink "lib/file-$$" or die "unlink: $!";
{
my $warnings = '';
local $SIG{__WARN__} = sub { $warnings .= join '', @_ };
- ok copy("file-$$", "file-$$");
+ ok copy("file-$$", "file-$$"), 'copy(fn, fn) succeeds';
- like $warnings, qr/are identical/;
- ok -s "file-$$";
+ like $warnings, qr/are identical/, 'but warns';
+ ok -s "file-$$", 'contents preserved';
}
move "file-$$", "lib";
open(R, "lib/file-$$") or die "open lib/file-$$: $!"; $foo = <R>; close(R);
- is $foo, "ok\n";
- ok !-e "file-$$";
+ is $foo, "ok\n", 'move(fn, dir): same contents';
+ ok !-e "file-$$", 'file moved indeed';
unlink "lib/file-$$" or die "unlink: $!";
SKIP: {
my $warnings = '';
local $SIG{__WARN__} = sub { $warnings .= join '', @_ };
- ok !copy("file-$$", "symlink-$$");
+ ok !copy("file-$$", "symlink-$$"), 'copy to itself (via symlink) fails';
- like $warnings, qr/are identical/;
+ like $warnings, qr/are identical/, 'emits a warning';
ok !-z "file-$$",
'rt.perl.org 5196: copying to itself would truncate the file';
}
SKIP: {
- skip "Testing hard links", 3 if !$Config{d_link} or $^O eq 'MSWin32';
+ skip "Testing hard links", 3
+ if !$Config{d_link} or $^O eq 'MSWin32' or $^O eq 'cygwin';
open(F, ">file-$$") or die $!;
print F "dummy content\n";
my $warnings = '';
local $SIG{__WARN__} = sub { $warnings .= join '', @_ };
- ok !copy("file-$$", "hardlink-$$");
+ ok !copy("file-$$", "hardlink-$$"), 'copy to itself (via hardlink) fails';
- like $warnings, qr/are identical/;
+ like $warnings, qr/are identical/, 'emits a warning';
ok ! -z "file-$$",
'rt.perl.org 5196: copying to itself would truncate the file';