1Fsdb::Filter::dbfilecatU(s3e)r Contributed Perl DocumentaFtsidobn::Filter::dbfilecat(3)
2
3
4

NAME

6       dbfilecat - concatenate two files with identical schema
7

SYNOPSIS

9           dbfilecat --input A.fsdb [--input B.fsdb...]
10
11       or
12
13           echo A.fsdb | dbfilecat --xargs
14

DESCRIPTION

16       Concatenate all provided input files, producing one result.  We remove
17       extra header lines.
18
19       Inputs can both be specified with "--input", or one can come from
20       standard input and the other from "--input".  With "--xargs", each line
21       of standard input is a filename for input.
22
23       Inputs must have identical schemas (columns, column order, and field
24       separators).
25
26       Like dbmerge, but no worries about sorting, and with no arguments we
27       read standard input (although that's not very useful).
28

OPTIONS

30       General option:
31
32       --xargs
33           Expect that input filenames are given, one-per-line, on standard
34           input.  (In this case, merging can start incrementally.
35
36       --removeinputs
37           Delete the source files after they have been consumed.  (Defaults
38           off, leaving the inputs in place.)
39
40           This module also supports the standard fsdb options:
41
42       -d  Enable debugging output.
43
44       -i or --input InputSource
45           Read from InputSource, typically a file name, or "-" for standard
46           input, or (if in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue
47           objects.
48
49       -o or --output OutputDestination
50           Write to OutputDestination, typically a file name, or "-" for
51           standard output, or (if in Perl) a IO::Handle, Fsdb::IO or
52           Fsdb::BoundedQueue objects.
53
54       --autorun or --noautorun
55           By default, programs process automatically, but Fsdb::Filter
56           objects in Perl do not run until you invoke the run() method.  The
57           "--(no)autorun" option controls that behavior within Perl.
58
59       --help
60           Show help.
61
62       --man
63           Show full manual.
64

SAMPLE USAGE

66   Input:
67       File a.fsdb:
68
69           #fsdb cid cname
70           11 numanal
71           10 pascal
72
73       File b.fsdb:
74
75           #fsdb cid cname
76           12 os
77           13 statistics
78
79   Command:
80           dbfilecat --input a.fsdb --input b.fsdb
81
82   Output:
83           #fsdb      cid     cname
84           11 numanal
85           10 pascal
86           12 os
87           13 statistics
88           #  | dbmerge --input a.fsdb --input b.fsdb
89

SEE ALSO

91       dbmerge(1), Fsdb(3)
92

CLASS FUNCTIONS

94   new
95           $filter = new Fsdb::Filter::dbmerge(@arguments);
96
97       Create a new object, taking command-line arguments.
98
99   set_defaults
100           $filter->set_defaults();
101
102       Internal: set up defaults.
103
104   parse_options
105           $filter->parse_options(@ARGV);
106
107       Internal: parse command-line arguments.
108
109   setup
110           $filter->setup();
111
112       Internal: setup, parse headers.
113
114   _run_one
115           $filter->_run_one();
116
117       Internal: stream out one input stream.
118
119   run
120           $filter->run();
121
122       Internal: run over each rows.
123
125       Copyright (C) 2013-2018 by John Heidemann <johnh@isi.edu>
126
127       This program is distributed under terms of the GNU general public
128       license, version 2.  See the file COPYING with the distribution for
129       details.
130
131
132
133perl v5.34.1                      2022-04-04        Fsdb::Filter::dbfilecat(3)
Impressum