NAME

       Catmandu::Importer::TSV - Package that imports tab-separated values

SYNOPSIS

           # From the command line

           # convert a TSV file to JSON
           catmandu convert TSV to JSON < journals.tab

           # Or in a Perl script

           use Catmandu;

           my $importer = Catmandu->importer('TSV', file => "/foo/bar.tab");

           my $n = $importer->each(sub {
               my $hashref = $_[0];
               # ...
           });

DESCRIPTION

       This package imports tab-separated values (TSV).  The object fields are read from the TSV header line or
       given via the "fields" parameter.

CONFIGURATION

       file
           Read  input  from  a  local file given by its path. Alternatively a scalar reference can be passed to
           read from a string.

       fh  Read input from an IO::Handle. If not specified, Catmandu::Util::io  is  used  to  create  the  input
           stream from the "file" argument or by using STDIN.

       encoding
           Binmode of the input stream "fh". Set to ":utf8" by default.

       fix An ARRAY of one or more fixes or file scripts to be applied to imported items.

       fields
           List  of  fields  to  be  used  as columns, given as array reference, comma-separated string, or hash
           reference. If "header" is 0 and "fields" is "undef" the fields will be named by  column  index  ("0",
           "1", "2", ...).

       header
           Read fields from a header line with the column names, if set to 1 (the default).

       sep_char
           Column separator ("tab" by default)

METHODS

       Every  Catmandu::Importer  is  a  Catmandu::Iterable  all its methods are inherited.  The methods are not
       idempotent: CSV streams can only be read once.

SEE ALSO

       Catmandu::Exporter::TSV

perl v5.36.0                                       2023-03-03                       Catmandu::Importer::TSV(3pm)