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;

           my $exporter = Catmandu->exporter(
                       'TSV',
                       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