The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

dbcoldefine - define the columns of a plain text file to make it an Fsdb file

SYNOPSIS

dbcoldefine [-F x] [column...]

DESCRIPTION

This program writes a new header before the data with the specified column names. It does not do any validation of the data contents; it is up to the user to verify that, other than the header, the input datastream is a correctly formatted Fsdb file.

OPTIONS

-F or --fs or --fieldseparator s

Specify the field separator.

--header H

Give the columns and field separator as a full Fsdb header (including #fsdb). Can only be used alone, not with other specifications.

This module also supports the standard fsdb options:

-d

Enable debugging output.

-i or --input InputSource

Read from InputSource, typically a file name, or - for standard input, or (if in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue objects.

-o or --output OutputDestination

Write to OutputDestination, typically a file name, or - for standard output, or (if in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue objects.

--autorun or --noautorun

By default, programs process automatically, but Fsdb::Filter objects in Perl do not run until you invoke the run() method. The --(no)autorun option controls that behavior within Perl.

--help

Show help.

--man

Show full manual.

SAMPLE USAGE

Input:

    102400      4937974.964736
    102400      4585247.875904
    102400      5098141.207123

Command:

    cat DATA/http_bandwidth | dbcoldefine size bw

Output:

    #fsdb size bw
    102400      4937974.964736
    102400      4585247.875904
    102400      5098141.207123
    # | dbcoldefine size bw

SEE ALSO

Fsdb. dbfilestripcomments

CLASS FUNCTIONS

new

    $filter = new Fsdb::Filter::dbcoldefine(@arguments);

Create a new dbcoldefine object, taking command-line arguments.

set_defaults

    $filter->set_defaults();

Internal: set up defaults.

parse_options

    $filter->parse_options(@ARGV);

Internal: parse command-line arguments.

setup

    $filter->setup();

Internal: setup, parse headers.

run

    $filter->run();

Internal: run over each rows.

AUTHOR and COPYRIGHT

Copyright (C) 1991-2016 by John Heidemann <johnh@isi.edu>

This program is distributed under terms of the GNU general public license, version 2. See the file COPYING with the distribution for details.