What does `Usage: Text::CSV_Xs::getline(self, io)` mean?

I'm not much of a programmer and pretty new to Perl. I'm currently writing a little script to read from a CSV, do some evaluation on different fields and then print to another file if certain criteria are met. I thought I was pretty much done but then I got this new message:

"Usage: Text::CSV_Xs::getline(self, io) at date_compare.pl line 51, line 3."

I've been trying to find something that tells me what this message means but I'm lost. I know this is something simple. My code is below. Please excuse my ignorance.

#! /usr/local/ActivePerl-5.12/bin/perl

#this script will check to files, throw them into arrays and compare them
#to find entries in one array which meet specified criteria
#$field_file is开发者_JAVA百科 the name of the file that contains the ablation date first,
#then the list of compared dates, then the low and high end date criteria, each
#value should end with a \n.
#$unfiltered_file is the name of the raw CSV with all the data
#$output_file is the name of the file the program will write to
use strict;
use 5.012;
use Text::CSV_XS;
use IO::HANDLE qw/getline/;
use Date::Calc qw/Decode_Date_US2 Delta_Days/;

my $csv = Text::CSV_XS->new ({ binary => 1, eol => $/ }) or
    die "Cannot use CSV: ".Text::CSV->error_diag ();

my ($field_file,
    $unfiltered_file,
    $output_file,
    @field_list,
    $hash_keys,
    %compare,
    $check,
    $i);
#Decode_Date_US2 scans a string and tries to parse any date within.
#($year,$month,$day)=Decode_Date_US2($string[,$language])
#Delta_Days returns the difference in days between the two given dates.
#$Dd = Delta_Days($year1,$month1,$day1, $year2,$month2,$day2);
sub days{
    Delta_Days(Decode_Days_US2(@compare{$field_list[0]}),
           Decode_Days_US2(@compare{$field_list[$i]}));
}

sub printout{
    $csv->print(<OUTPUTF>, $check) or die "$output_file:".$csv->error_diag();
}

print "\nEnter the check list file name: ";
chomp ($field_file = <STDIN>);
open FIELDF, "<", $field_file or die "$field_file: $!";
chomp (@field_list=<$field_file>);
close FIELDF or die "$field_file: $!";
print "\nEnter the raw CSV file name: ";
chomp ($unfiltered_file = <STDIN>);
print "\nEnter the output file name : ";
chomp ($output_file = <STDIN>);
open OUTPUTF, ">>", $output_file or die "$output_file: $!";
open RAWF, "<", $unfiltered_file or die "$unfiltered_file: $!";
if ($hash_keys = $csv->getline(<RAWF>)){
    $check = $hash_keys;
    &printout();
}else{die "\$hash_keys: ".$csv->error_diag();}

while ($check = $csv->getline (<RAWF>)){
    @compare{@$hash_keys}=@$check;    
    TEST: for ($i=1, $i==(@field_list-3), $i++){
        if (&days()>=$field_list[-2] && &days()<=$field_list[-1]){
            last TEST if (&printout());
    }
}    

---

Usage: Text::CSV_Xs::getline(self, io) at date_compare.pl line 51, line 3.

getline apparently expects a filehandle/IO::Handle, and you're passing it a scalar (containing a line read from the filehandle).

This means that on your line:

if ($hash_keys = $csv->getline(<RAWF>)){

You should be using:

if ($hash_keys = $csv->getline( \*RAWF )){

instead.

(But you should really be using lexical filehandles, as in:)

open FIELDF, "<", $field_file or die "$field_file: $!";
chomp (@field_list=<$field_file>);       # Not sure how you expect this to work
close FIELDF or die "$field_file: $!";

would become:

open my $fieldf, "<", $field_file or die "$field_file: $!";
chomp (@field_list=<$fieldf>);
close $fieldf or die "$field_file: $!";