Fsdb::F...oldefine(3)

📦
version 3.9 · 3 versions
, in epel 9

💖 NAME 💖

dbcoldefine — okay so this one's whole job is: it slaps a fresh header on your plain text file and boom, now it's an Fsdb file. That's it. That's the gig. 👑

(also hi, you're reading the Fsdb::Filter::dbcoldefine manual page, section 3 of the perl docs — welcome bestie 🫶)

✨ SYNOPSIS ✨

dbcoldefine [-F x] [column...]

🦋 DESCRIPTION 🦋

So basically this program writes a brand new header in front of your data, using whatever column names you hand it. And like — it is not checking your work. No validation of the data contents at all, none, zero, zip. 🙈

It is literally up to you, the user, to verify that (aside from the header) the input datastream is a correctly formatted Fsdb file. The tool trusts you completely. Main character energy, honestly.

🌸 OPTIONS 🌸

  • -F or --fs or --fieldseparator s — specify the field separator. Pick your delimiter, bestie.
  • --header H — give the columns and the field separator as one full Fsdb header (like, #fsdb and all of it 😤). Heads up: this one can only be used alone, not with any other specifications. Solo act. 🎤

This module also supports the standard fsdb options, which are:

  • -d — enable debugging output.
  • -i or --input InputSource — read from InputSource. Usually a file name, or - for standard input, or (if you're in Perl) an IO::Handle, Fsdb::IO or Fsdb::BoundedQueue object.
  • -o or --output OutputDestination — write to OutputDestination. Usually a file name, or - for standard output, or (if you're in Perl) an IO::Handle, Fsdb::IO or Fsdb::BoundedQueue object.
  • --autorun or --noautorun — by default programs just 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 the full manual.

🎀 SAMPLE USAGE 🎀

Input:

    102400      4937974.964736
    102400      4585247.875904
    102400      5098141.207123

Command:

cat DATA/http_bandwidth | dbcoldefine size bw

Output:

#fsdb size bw
102400      4937974.964736
102400      4585247.875904
102400      5098141.207123
# | dbcoldefine size bw

Look at that header just appearing. Iconic. 💅

👑 SEE ALSO 👑

Fsdb. dbfilestripcomments.

💜 CLASS FUNCTIONS 💜

new

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

Create a new dbcoldefine object, taking command-line arguments. Fresh object, fresh vibes.

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.

Copyright (C) 1991-2016 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, ily, go define some columns bestie 🧚💖

perl v5.32.1 — 2024-08-02 — User Contributed Perl Documentation — Fsdb::Filter::dbcoldefine(3), signing off 😭🫶

📦 where this page comes from