1Fsdb::Filter::dbcolneatUesne(r3)Contributed Perl DocumenFtsadtbi:o:nFilter::dbcolneaten(3)
2
3
4
6 dbcolneaten - pretty-print columns of Fsdb data (assuming a monospaced
7 font)
8
10 dbcolneaten [-E] [field_settings]
11
13 dbcolneaten arranges that the Fsdb data appears in neat columns if you
14 view it with a monospaced font. To do this, it pads out each field
15 with spaces to line up the next field.
16
17 Field settings are of the form
18
19 field op value
20
21 OP is >=, =, or <= specifying that the width of that FIELD must be
22 more, equal, or less than that VALUE
23
24 dbcolneaten runs in O(1) memory but disk space proportional to the size
25 of data.
26
28 -E or --noeoln
29 Omit padding for the last column (at the end-of-the-line).
30 (Default behavior.)
31
32 -e or --eoln
33 Do padding and include an extra field separator after the last
34 column. (Useful if you're interactively adding a column.)
35
36 This module also supports the standard fsdb options:
37
38 -d Enable debugging output.
39
40 -i or --input InputSource
41 Read from InputSource, typically a file name, or "-" for standard
42 input, or (if in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue
43 objects.
44
45 -o or --output OutputDestination
46 Write to OutputDestination, typically a file name, or "-" for
47 standard output, or (if in Perl) a IO::Handle, Fsdb::IO or
48 Fsdb::BoundedQueue objects.
49
50 --autorun or --noautorun
51 By default, programs process automatically, but Fsdb::Filter
52 objects in Perl do not run until you invoke the run() method. The
53 "--(no)autorun" option controls that behavior within Perl.
54
55 --help
56 Show help.
57
58 --man
59 Show full manual.
60
62 Input:
63 #fsdb fullname homedir uid gid
64 Mr._John_Heidemann_Junior /home/johnh 2274 134
65 Greg_Johnson /home/greg 2275 134
66 Root /root 0 0
67 # this is a simple database
68 # | dbcol fullname homedir uid gid
69
70 Command:
71 dbcolneaten
72
73 Output:
74 #fsdb -F s fullname homedir uid gid
75 Mr._John_Heidemann_Junior /home/johnh 2274 134
76 Greg_Johnson /home/greg 2275 134
77 Root /root 0 0
78 # this is a simple database
79 # | dbcol fullname homedir uid gid
80 # | dbcolneaten
81
83 Does not handle tab separators correctly.
84
86 Fsdb.
87
89 new
90 $filter = new Fsdb::Filter::dbcolneaten(@arguments);
91
92 Create a new dbcolneaten object, taking command-line arguments.
93
94 set_defaults
95 $filter->set_defaults();
96
97 Internal: set up defaults.
98
99 parse_options
100 $filter->parse_options(@ARGV);
101
102 Internal: parse command-line arguments.
103
104 setup
105 $filter->setup();
106
107 Internal: setup, parse headers.
108
109 format_header
110 $filter->format_header($out)
111
112 Format the header for the current object to output stream $out.
113
114 run
115 $filter->run();
116
117 Scan the data once, then rewrite it neatly.
118
120 Copyright (C) 1991-2018 by John Heidemann <johnh@isi.edu>
121
122 This program is distributed under terms of the GNU general public
123 license, version 2. See the file COPYING with the distribution for
124 details.
125
126
127
128perl v5.38.0 2023-07-20 Fsdb::Filter::dbcolneaten(3)