DBCOLDEFINE(1)

📦
version 3.9 · 3 versions
, in epel 9

🎀 DBCOLDEFINE(1) 🎀

okay so bestie, you're looking at dbcoldefine from the User Contributed Perl Documentation section, and honestly? it's a little icon. let's get into it 💅

✨ NAME ✨

dbcoldefine — the girl whose whole job is defining the columns of a plain text file so it can ~become~ an Fsdb file. glow-up complete, no cap 💖

🌸 SYNOPSIS 🌸

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

🦋 DESCRIPTION 🦋

so here's the vibe: this program writes a new header before your data, using whatever column names you gave it. that's it, that's the whole plot. ✨

and listen — it does not validate the contents of your data. like, at all. it's not doing a vibe check on your numbers, bestie 🙈. it is up to the user to verify that, other than the header, the input datastream is a correctly formatted Fsdb file. so basically the header's a slay, but the rest of the file? you gotta make sure that's actually correct yourself, fr fr.

💜 OPTIONS 💜

  • -F, --fs, or --fieldseparator s — specify the field separator. that's the thing between your fields, iykyk 🫶
  • --header H — give the columns and the field separator as a full Fsdb header (including #fsdb). ⚠️ this one can only be used alone — not with other specifications. like it's a solo main character, it does not share the spotlight 💅

⭐ the standard fsdb options ⭐

this module also supports the standard fsdb options, and yes you get all of them:

  • -d — enable debugging output. turn it on when you need to see what's going on 👀
  • -i or --input InputSource — read from InputSource. typically that's a file name, or - for standard input, or (if you're in Perl) IO::Handle, Fsdb::IO or Fsdb::BoundedQueue objects. flexible queen 🌈
  • -o or --output OutputDestination — write to OutputDestination. typically a file name, or - for standard output, or (if you're in Perl) 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. we love a helper 🫶
  • --man — show the full manual. that's where you are right now bestie 💖

🔥 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

like LOOK at that header appearing out of nowhere. ate. 👑

🌈 SEE ALSO 🌈

  • Fsdb.
  • dbfilestripcomments

go read those next, bestie, they're literally right there 📚✨

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 🎀

ngl the one thing to remember: the header gets written, the data does not get checked. you're the validator here, bestie. no pressure 💀

and that's the whole page, bestie!! 🦋 this was DBCOLDEFINE(1) from perl v5.32.1, dated 2024-08-02 — mwah, go define some columns 💖✨💅

📦 where this page comes from