Fsdb::F...olrename(3)

✨ NAME ✨

okay so bestie, welcome to the Fsdb::F...olrename(3) page from the User Contributed Perl Documentation — yes, that whole manual-name situation is folded right here at the top. 💖 the command is dbcolrename, and its whole job is change the names of columns in a fsdb schema. iconic, honestly.

🌸 SYNOPSIS 🌸

dbcolrename OldName1 NewName1 [OldName2 NewName2] ...

🦋 DESCRIPTION 🦋

Dbcolrename changes the names of columns in a fsdb schema, mapping OldName1 to NewName1, and so on for multiple pairs of column names.

Note that it is valid to do "overlapping" renames like dbcolrename a b b a.

💅 OPTIONS 💅

No non-standard options. periodt. 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 🍓

okay, real talk, here's the whole sample usage moment:

🌟 Input:

#fsdb account passwd uid gid fullname homedir shell
johnh * 2274 134 John_Heidemann /home/johnh /bin/bash
greg * 2275 134 Greg_Johnson /home/greg /bin/bash
root * 0 0 Root /root /bin/bash
# this is a simple database

🎀 Command:

cat DATA/passwd.fsdb | dbcolrename fullname first_last

🌈 Output:

#fsdb      account passwd  uid     gid     first_last      homedir shell
johnh * 2274 134 John_Heidemann /home/johnh /bin/bash
greg * 2275 134 Greg_Johnson /home/greg /bin/bash
root * 0 0 Root /root /bin/bash
# this is a simple database
#  | dbcolrename fullname first_last

🔥 SEE ALSO 🔥

Fsdb. go see Fsdb too, bestie.

🧚 CLASS FUNCTIONS 🧚

these are the class functions — internal-ish stuff, but we keep every signature because details are the whole vibe:

💜 new

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

Create a new dbcolrename 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's the whole page, bestie — this footer situation is perl v5.32.1, dated 2024-08-02, for Fsdb::F...olrename(3). mwah 💅✨