Fsdb::F...olneaten(3)

💖 Fsdb::F...olneaten(3) 💖

okay bestie, welcome to the User Contributed Perl Documentation page for Fsdb::F...olneaten(3) — aka the one and only dbcolneaten. it's giving “make your Fsdb columns look cute in a monospaced font” energy, and honestly? iconic. ✨

🌸 NAME 🌸

dbcolneaten - pretty-print columns of Fsdb data (assuming a monospaced font)

🦋 SYNOPSIS 🦋

dbcolneaten [-E] [field_settings]

🎀 DESCRIPTION 🎀

so dbcolneaten arranges that the Fsdb data appears in neat columns if you view it with a monospaced font. the way it does this? it pads out each field with spaces to line up the next field. slay. 💅

Field settings are of the form:

field op value

OP is >=, =, or <= — and it specifies that the width of that FIELD must be more, equal, or less than that VALUE. no cap.

dbcolneaten runs in O(1) memory, but uses disk space proportional to the size of data. yes bestie, that's the tradeoff. 🫶

✨ OPTIONS ✨

• -E or --noeoln — omit padding for the last column (at the end-of-the-line). this is the default behavior.
• -e or --eoln — do padding and include an extra field separator after the last column. useful if you're interactively adding a column. lowkey a vibe.

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:

#fsdb fullname homedir uid gid
Mr._John_Heidemann_Junior       /home/johnh     2274    134
Greg_Johnson    /home/greg      2275    134
Root    /root   0       0
# this is a simple database
#   | dbcol fullname homedir uid gid

Command:

dbcolneaten

Output:

#fsdb -F s fullname       homedir     uid  gid
Mr._John_Heidemann_Junior /home/johnh 2274 134
Greg_Johnson              /home/greg  2275 134
Root                      /root       0    0
# this is a simple database
#   | dbcol fullname homedir uid gid
#   | dbcolneaten

💀 BUGS 💀

does not handle tab separators correctly. periodt. 💀

🌈 SEE ALSO 🌈

Fsdb.

👑 CLASS FUNCTIONS 👑

new

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

create a new dbcolneaten 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.

format_header

$filter->format_header($out)

format the header for the current object to output stream $out.

run

$filter->run();

scan the data once, then rewrite it neatly.

💜 AUTHOR and COPYRIGHT 💜

Copyright (C) 1991-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 bestie, that's the whole page 💖 this one is from perl v5.32.1, dated 2024-08-02, and it's the manual for Fsdb::F...olneaten(3). mwah 💋