1Fsdb::Filter::dbcolcreaUtsee(r3)Contributed Perl DocumenFtsadtbi:o:nFilter::dbcolcreate(3)
2
3
4
6 dbcolcreate - create new columns
7
9 dbcolcreate NewColumn1 [NewColumn2]
10
11 or
12
13 dbcolcreate -e DefaultValue NewColumnWithDefault
14
16 Create columns "NewColumn1", etc. with an optional "DefaultValue".
17
19 -e EmptyValue or --empty
20 Specify the value newly created columns get.
21
22 -f or --first
23 Put all new columns as the first columns of each row. By default,
24 they go at the end of each row.
25
26 --no-recreate-fatal
27 By default, creating an existing column is an error. With
28 --no-recreate-fatal, we ignore re-creation.
29
30 This module also supports the standard fsdb options:
31
32 -d Enable debugging output.
33
34 -i or --input InputSource
35 Read from InputSource, typically a file name, or "-" for standard
36 input, or (if in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue
37 objects.
38
39 -o or --output OutputDestination
40 Write to OutputDestination, typically a file name, or "-" for
41 standard output, or (if in Perl) a IO::Handle, Fsdb::IO or
42 Fsdb::BoundedQueue objects.
43
44 --autorun or --noautorun
45 By default, programs process automatically, but Fsdb::Filter
46 objects in Perl do not run until you invoke the run() method. The
47 "--(no)autorun" option controls that behavior within Perl.
48
49 --header H
50 Use H as the full Fsdb header, rather than reading a header from
51 then input.
52
53 --help
54 Show help.
55
56 --man
57 Show full manual.
58
60 Input:
61 #fsdb test
62 a
63 b
64
65 Command:
66 cat data.fsdb | dbcolcreate foo
67
68 Output:
69 #fsdb test foo
70 a -
71 b -
72
74 Fsdb.
75
77 new
78 $filter = new Fsdb::Filter::dbcolcreate(@arguments);
79
80 Create a new dbcolcreate object, taking command-line arguments.
81
82 set_defaults
83 $filter->set_defaults();
84
85 Internal: set up defaults.
86
87 parse_options
88 $filter->parse_options(@ARGV);
89
90 Internal: parse command-line arguments.
91
92 setup
93 $filter->setup();
94
95 Internal: setup, parse headers.
96
97 run
98 $filter->run();
99
100 Internal: run over each rows.
101
103 Copyright (C) 1991-2022 by John Heidemann <johnh@isi.edu>
104
105 This program is distributed under terms of the GNU general public
106 license, version 2. See the file COPYING with the distribution for
107 details.
108
109
110
111perl v5.38.0 2023-07-20 Fsdb::Filter::dbcolcreate(3)