Scroll to navigation

Catmandu::Exporter::TSV(3pm) User Contributed Perl Documentation Catmandu::Exporter::TSV(3pm)

NAME

Catmandu::Exporter::TSV - a tab-delimited TSV exporter

SYNOPSIS

    # From the command line

    $ catmandu convert JSON to TSV --fields "id,title,year" < data.json

    # In a Perl script

    use Catmandu::Exporter::TSV;

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

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

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

    $exporter->add($hashref);

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

DESCRIPTION

This "Catmandu::Exporter" exports items as rows with tab-separated values (TSV). A header line with field names will be included if option "header" is set. See Catmandu::TabularExporter on how to configure the field mapping and column names. Newlines and tabulator values in field values are escaped as "\n", "\r", and "\t".

CONFIGURATION

file
Write output to a local file given by its path or file handle. Alternatively a scalar reference can be passed to write to a string and a code reference can be used to write to a callback function.
fh
Write the output to an IO::Handle. If not specified, Catmandu::Util::io is used to create the output handle from the "file" argument or by using STDOUT.
fix
An ARRAY of one or more fixes or file scripts to be applied to exported items.
encoding
Binmode of the output stream "fh". Set to "":utf8"" by default.
fields
See Catmandu::TabularExporter.
columns
See Catmandu::TabularExporter.
header
Include a header line with column names. Enabled by default.
sep_char
Column separator ("tab" by default)

METHODS

See Catmandu::TabularExporter, Catmandu::Exporter, Catmandu::Addable, Catmandu::Fixable, Catmandu::Counter, and Catmandu::Logger for a full list of methods.

SEE ALSO

Catmandu::Importer::TSV
2017-01-04 perl v5.24.1