This manual page is for Mac OS X version 10.6

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • For more information about the manual page format, see the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.



File::Compare(3pm)                    Perl Programmers Reference Guide                    File::Compare(3pm)



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.



perl v5.10.0                                     2007-12-18                               File::Compare(3pm)

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation to the Perl project. (See perlbug(1) for submission instructions.)
Bug reports
Report bugs in the functionality of the described tool or API to Apple through Bug Reporter and to the Perl project using perlbug(1).
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.