NAME

Catmandu::Exporter::CSV - a CSV exporter

SYNOPSIS

    use Catmandu::Exporter::CSV;

    my $exporter = Catmandu::Exporter::CSV->new(
                                fix => 'myfix.txt'
                                quote_char => '"' ,
                                sep_char => ',' ,
                                header => 1);

    $exporter->fields("f1,f2,f3");
    $exporter->fields([qw(f1 f2 f3)]);

    # add custom header labels
    $exporter->header({f2 => 'field two'});

    $exporter->add_many($arrayref);
    $exporter->add_many($iterator);
    $exporter->add_many(sub { });

    $exporter->add($hashref);

    printf "exported %d objects\n" , $exporter->count;

METHODS

new(quote_char => STRING, sep_char => STRING, header => 0|1|HASH, fields => ARRAY|HASH|STRING)

Creates a new Catmandu::Exporter::CSV. Optionally set the field and column boundaries with quote_char and sep_char. A header line with field names will be included if header is set. Field names can be read from the first item exported or set by the fields argument (see: fields).

fields($arrayref)

Set the field names by an ARRAY reference.

fields($hashref)

Set the field names by the keys of a HASH reference.

fields($string)

Set the fields by a comma delimited string.

header(1)

Include a header line with the field names

header($hashref)

Include a header line with custom field names