DBFILECAT(1)

📦
version 3.9 · 3 versions
, in epel 9

🦋 DBFILECAT(1) 🦋

okay so this is dbfilecat(1) from the User Contributed Perl Documentation zone, and it's literally the "smush two files with the same schema together" bestie. it's giving file-glue realness. periodt. 💖

🌸 NAME 🌸

dbfilecat - concatenate two files with identical schema.

✨ SYNOPSIS ✨

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

or

echo A.fsdb | dbfilecat --xargs

🎀 DESCRIPTION 🎀

okay so what it does: you give it all the input files, and it concatenates them into one result. We remove extra header lines, because we are not keeping the clutter. the way that it just drops those extra headers? iconic. 💅

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. iykyk. 🫶

Inputs must have identical schemas — same columns, same column order, and same field separators. this is a hard vibe check, bestie, 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). fr fr. 😭

🌟 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. not me being obsessed with cleanup energy. 💀

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

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.

okay bye bestie 💖 — this page is from perl v5.32.1, dated 2024-08-02. slay. 💅

📦 where this page comes from