Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

File::Compare (3)

Name

File::Compare - Compare files or filehandles

Synopsis

use File::Compare;

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

Description

Perl Programmers Reference Guide                              File::Compare(3)



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.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | runtime/perl-532      |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+

NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://www.cpan.org/src/5.0/perl-5.32.0.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.perl.org/.



perl v5.32.0                      2020-06-14                  File::Compare(3)