Fsdb::F...bfilecat(3)

🌸 NAME 🌸

dbfilecat — concatenate two files with identical schema. That’s the whole assignment, bestie. This is the Fsdb::F...bfilecat(3) page from User Contributed Perl Documentation, and we’re keeping every fact while making it cute. 💖

✨ SYNOPSIS ✨

Okay so you run it like this:

dbfilecat --input A.fsdb [--input B.fsdb...]

or

echo A.fsdb | dbfilecat --xargs

🦋 DESCRIPTION 🦋

Concatenate all provided input files, producing one result. We remove extra header lines. 🎀

Inputs can both be specified with --input, or one can come from standard input and the other from --input. With --xargs, each line of standard input is a filename for input. Yep, one filename per line — group-chat rules. 💅

Inputs must have identical schemas — columns, column order, and field separators. No cap.

It’s like dbmerge, but no worries about sorting, and with no arguments we read standard input (although that’s not very useful).

💅 OPTIONS 💅

💖 General option 💖

• --xargs — expect that input filenames are given, one-per-line, on standard input. (In this case, merging can start incrementally.) ✨
• --removeinputs — delete the source files after they have been consumed. Defaults off, leaving the inputs in place. 🫶

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) 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) 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 🌈

File a.fsdb:

#fsdb cid cname
11 numanal
10 pascal

File b.fsdb:

#fsdb cid cname
12 os
13 statistics

👑 Command 👑

dbfilecat --input a.fsdb --input b.fsdb

⭐ Output ⭐

#fsdb      cid     cname
11 numanal
10 pascal
12 os
13 statistics
#  | dbmerge --input a.fsdb --input b.fsdb

🔥 SEE ALSO 🔥

dbmerge(1), Fsdb(3) — go read those too, iykyk. 💜

🧚 CLASS FUNCTIONS 🧚

💜 new 💜

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

Create a new object, taking command-line arguments. ✨

💜 set_defaults 💜

$filter->set_defaults();

Internal: set up defaults.

💜 parse_options 💜

$filter->parse_options(@ARGV);

Internal: parse command-line arguments.

💜 setup 💜

$filter->setup();

Internal: setup, parse headers.

💜 _run_one 💜

$filter->_run_one();

Internal: stream out one input stream.

💜 run 💜

$filter->run();

Internal: run over each rows.

🌈 AUTHOR and COPYRIGHT 🌈

Copyright (C) 2013-2018 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.

---

And that’s the whole entire Fsdb::F...bfilecat(3) moment, bestie — this page is from perl v5.32.1, dated 2024-08-02, and the footer says Fsdb::F...bfilecat(3) too. Periodt. 💅✨