new

        my $parser = Text::CSV::Simple->new(\%options);

Construct a new parser. This takes all the same options as Text::CSV_XS.

read_file

        my @data = $parser->read_file($filename);

Read the data in the given file, parse it, and return it as a list of data.

Each entry in the returned list will be a listref of parsed CSV data.

want_fields

        $parser->want_fields(1, 2, 4, 8);

If you only want to extract certain fields from the CSV, you can set up the list of fields you want, and, hey presto, those are the only ones that will be returned in each listref. The fields, as with Perl arrays, are zero based (i.e. the above example returns the second, third, fifth and ninth entries for each line)

field_map

        $parser->field_map(qw/id name null town null postcode/);

Rather than getting back a listref for each entry in your CSV file, you often want a hash of data with meaningful names. If you set up a field_map giving the name you'd like for each field, then we do the right thing for you! Fields named 'null' vanish into the ether.

before_parse

  $parser->add_trigger(before_parse => sub {
    my ($self, $line) = @_;
    die unless $line =~ /wanted/i;
  });

Before we call Text::CSV_XS 'parse' on each line of input text, we call the before_parse trigger with that line of text.

after_parse

  $parser->add_trigger(after_parse => sub {
    my ($self, $data) = @_;
    die unless $wanted{$data->[0]};
  });

After we sucessfully call Text::CSV_XS 'parse' on each line of input text, we call the after_parse trigger with a list ref of the values

error

        $parser->add_trigger(on_failure => sub { 
                my ($self, $csv) = @_;
                warn "Failed on " . $csv->error_input . "\n";
        });