Ricardo SIGNES > perl-5.19.8 > File::Compare

Download:
perl-5.19.8.tar.bz2

Dependencies

Annotate this POD

Website

Related Modules

File::Find
Digest::MD5
Algorithm::Diff
File::Copy
Module::Build
File::Basename
Array::Compare
Win32::API
File::Slurp
Getopt::Long
more...
By perlmonks.org
Module Version: 1.1006   Source   Latest Release: perl-5.21.5

NAME ^

File::Compare - Compare files or filehandles

SYNOPSIS ^

        use File::Compare;

        if (compare("file1","file2") == 0) {
            print "They're equal\n";
        }

DESCRIPTION ^

The File::Compare::compare function compares the contents of two sources, each of which can be a file or a file handle. It is exported from File::Compare by default.

File::Compare::cmp is a synonym for File::Compare::compare. It is exported from File::Compare only by request.

File::Compare::compare_text does a line by line comparison of the two files. It stops as soon as a difference is detected. compare_text() accepts an optional third argument: This must be a CODE reference to a line comparison function, which returns 0 when both lines are considered equal. For example:

    compare_text($file1, $file2)

is basically equivalent to

    compare_text($file1, $file2, sub {$_[0] ne $_[1]} )

RETURN ^

File::Compare::compare and its sibling functions return 0 if the files are equal, 1 if the files are unequal, or -1 if an error was encountered.

AUTHOR ^

File::Compare was written by Nick Ing-Simmons. Its original documentation was written by Chip Salzenberg.

syntax highlighting: