1Fsdb::Filter::dbfilevalUisdearteC(o3n)tributed Perl DocuFmsednbt:a:tFiiolnter::dbfilevalidate(3)
2
3
4

NAME

6       dbfilevalidate - insure the source input is a well-formed Fsdb file
7

SYNOPSIS

9           dbfilevalidate [-vc]
10

DESCRIPTION

12       Validates the input file to make sure it is a well-formed fsdb file.
13       If the file is well-formed, it outputs the whole file and exits with a
14       good exit code.  For invalid files, it exits with an error exit code
15       and embedded error messages in the stream as comments with "***" in
16       them.
17
18       Currently this program checks for rows with missing or extra columns.
19

OPTIONS

21       -v or --errors-only
22           Output only broken lines, not the whole thing.
23
24       -c or --correct
25           Correct errors, if possible.  Pad out rows with the empty value;
26           truncate rows with extra values.  If errors can be corrected the
27           program exits with a good return code.
28
29       "-e E" or "--empty E"
30           give value E as the value for empty (null) records
31
32       This module also supports the standard fsdb options:
33
34       -d  Enable debugging output.
35
36       -i or --input InputSource
37           Read from InputSource, typically a file name, or "-" for standard
38           input, or (if in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue
39           objects.
40
41       -o or --output OutputDestination
42           Write to OutputDestination, typically a file name, or "-" for
43           standard output, or (if in Perl) a IO::Handle, Fsdb::IO or
44           Fsdb::BoundedQueue objects.
45
46       --autorun or --noautorun
47           By default, programs process automatically, but Fsdb::Filter
48           objects in Perl do not run until you invoke the run() method.  The
49           "--(no)autorun" option controls that behavior within Perl.
50
51       --help
52           Show help.
53
54       --man
55           Show full manual.
56

SAMPLE USAGE

58   Input:
59           #fsdb sid cid
60           1 10
61           2
62           1 12
63           2 12
64
65   Command:
66           cat TEST/dbfilevalidate_ex.in | dbvalidate
67
68   Output:
69           #fsdb sid cid
70           1 10
71           2
72           # *** line above is missing field cid.
73           1 12
74           2 12
75           #  | dbfilevalidate
76

SEE ALSO

78       Fsdb.
79

CLASS FUNCTIONS

81   new
82           $filter = new Fsdb::Filter::dbfilevalidate(@arguments);
83
84       Create a new dbfilevalidate object, taking command-line arguments.
85
86   set_defaults
87           $filter->set_defaults();
88
89       Internal: set up defaults.
90
91   parse_options
92           $filter->parse_options(@ARGV);
93
94       Internal: parse command-line arguments.
95
96   setup
97           $filter->setup();
98
99       Internal: setup, parse headers.
100
101   run
102           $filter->run();
103
104       Internal: run over each rows.
105
106   finish
107           $filter->finish();
108
109       Internal: write trailer.
110

112       Copyright (C) 1991-2008 by John Heidemann <johnh@isi.edu>
113
114       This program is distributed under terms of the GNU general public
115       license, version 2.  See the file COPYING with the distribution for
116       details.
117
118
119
120perl v5.38.0                      2023-07-20   Fsdb::Filter::dbfilevalidate(3)
Impressum