Fsdb::F...olcreate(3)

okay so bestie, welcome to the Fsdb::F...olcreate(3) manual page — this one is all about dbcolcreate, and it is lowkey iconic 💅✨

🌸 NAME 🌸

dbcolcreate — create new columns. That is literally the whole name vibe.

✨ SYNOPSIS ✨

Two moods, depending on whether you want a default value:

dbcolcreate NewColumn1 [NewColumn2]

or

dbcolcreate -e DefaultValue NewColumnWithDefault

🦋 DESCRIPTION 🦋

Create columns NewColumn1, etc. with an optional DefaultValue. Slay.

🎀 OPTIONS 🎀

• -e EmptyValue or --empty — Specify the value newly created columns get. (This is the DefaultValue moment, iykyk.)
• -f or --first — Put all new columns as the first columns of each row. By default, they go at the end of each row.
• --no-recreate-fatal — By default, creating an existing column is an error. With --no-recreate-fatal, we ignore re-creation.

This module also supports the standard fsdb options:

• -d — Enable debugging output.
• -i InputSource 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 OutputDestination 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.
• --header H — Use H as the full Fsdb header, rather than reading a header from then input.
• --help — Show help.
• --man — Show full manual.

🍓 SAMPLE USAGE 🍓

Input:

#fsdb test
a
b

Command:

cat data.fsdb | dbcolcreate foo

Output:

#fsdb      test    foo
a       -
b       -

💜 SEE ALSO 💜

Fsdb. Go give it a lil kiss 🫶

👑 CLASS FUNCTIONS 👑

🌱 new

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

Create a new dbcolcreate 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

$filter->run();

Internal: run over each rows.

🌈 AUTHOR and COPYRIGHT 🌈

Copyright (C) 1991-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 that is the whole manual, bestie 💖 source/version: perl v5.32.1, dated 2024-08-02, for Fsdb::F...olcreate(3). Periodt. 🎀