Fsdb::F...owcount(3)

🌸 NAME

okay so the main character here is dbrowcount, and its whole vibe is literally just counting the number of rows in an Fsdb stream. This page is the Fsdb::F...owcount(3) manual from User Contributed Perl Documentation, and yes bestie, we're getting into it. 💅

✨ SYNOPSIS

dbrowcount

🦋 DESCRIPTION

dbrowcount counts the number of rows and writes out a new fsdb file with one column (n) and one value: the number of rows. It is a strict subset of dbcolstats, no cap.

There are other ways to get a row count out here — dbcolstats, or dbrowaccumulate -C 1 plus some processing — but counting is so common it warrants its own command. Think about how often wc -l shows up in regular shell scripting. Iconic behavior, honestly.

There are some gross and subtle differences, though: dbrowcount doesn't require you to specify a column to search, and it also doesn't look for and skip null data items. Periodt.

🎀 OPTIONS

No program-specific options. Not a single one, bestie.

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) an 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) an 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:

#fsdb      absdiff
0
0.046953
0.072074
0.075413
0.094088
0.096602
#  | /home/johnh/BIN/DB/dbrow
#  | /home/johnh/BIN/DB/dbcol event clock
#  | dbrowdiff clock
#  | /home/johnh/BIN/DB/dbcol absdiff

Command:

cat data.fsdb | dbrowcount

Output:

#fsdb n
6
#  | /home/johnh/BIN/DB/dbrow
#  | /home/johnh/BIN/DB/dbcol event clock
#  | dbrowdiff clock
#  | /home/johnh/BIN/DB/dbcol absdiff

Input 2:

As another example, bestie, this input produces the same output as above in dbrowcount, but different output in dbstats:

#fsdb      absdiff
-
-
-
-
-
-
#  | /home/johnh/BIN/DB/dbrow
#  | /home/johnh/BIN/DB/dbcol event clock
#  | dbrowdiff clock
#  | /home/johnh/BIN/DB/dbcol absdiff

💖 SEE ALSO

• dbcolaccumulate(1)
• dbcolstats(1)
• Fsdb(3)

🧚 CLASS FUNCTIONS

new

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

set_defaults

$filter->set_defaults();

Internal: set up defaults.

parse_options

$filter->parse_options(@ARGV);

Internal: parse options.

setup

$filter->setup();

Internal: setup, parse headers.

run

$filter->run();

Internal: run over all IO.

finish

$filter->finish();

Internal: write trailer.

👑 AUTHOR and COPYRIGHT

Copyright (C) 2007-2022 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.

---

okay bestie, that's the whole page. it's the Fsdb::F...owcount(3) manual from User Contributed Perl Documentation, and the footer says perl v5.32.1, dated 2024-08-02. mwah 💋✨🫶