CIFVALUES(1)

🎀 CIFVALUES(1) 🎀

okay so bestie, welcome to cifvalues — it lives in the General Commands Manual, section 1, and it's about to become your whole personality. 💖

---

✨ NAME ✨

cifvalues — get specified data values from a CIF file(s). periodt 💅

---

🦋 SYNOPSIS 🦋

three ways to run it, all equally iconic:

src/components/codcif/cifvalues --options < input.cif

src/components/codcif/cifvalues --options input.cif

src/components/codcif/cifvalues --options input1.cif input2.cif inputs*.cif

---

🌸 DESCRIPTION 🌸

Get specified data values from a CIF file(s).

and that's literally the whole description. no notes. you point it at a CIF file (or several), you tell it which data items you want, and it hands them over. main character energy fr fr 🫶

---

👑 OPTIONS 👑

okay this is the part where you actually pay attention, no cap. every single one, in order:

• -h, --header, -h-, --no-header — print the column name header, or don't print it (that's the default). the header is opt-in, bestie
• -t, --tags _cell_length_a,_cell_volume_ — extract the specified data items. there is no default — you gotta name your tags yourself.
• -g, --group-separator $'\0' and --newline-characters $'\0' — specify a group separator that separates the TSV/CSV/ADT "lines" (default "\0").
• -r, --record-separator $'' and --separator $'' — use the specified string to separate values of different data items (default " ").
• -u, --unit-separator "|", --value-separator "|", --vseparator "|" — use the specified string to separate multiple values of each looped data item (default "|"). yes, three names, same slay. ✨
• -p, --replacement " " — a character to which all separators are replaced in the non-quoting output formats (TSV and ADT).
• -q, --quote '"' — quote the strings containing separators using the specified quoting character (the default for CSV output).
• -q-, --no-quote — do not quote the strings containing separators, replace separators by the --replacement character instead.
• -Q, --always-quote — always quote the values, even if they do not contain separators. extra? yes. valid? also yes.
• -Q-, --not-always-quote — quote the values only if they contain separators (default).
• -D, --dos-newlines
• -M, --mac-newlines
• -U, --unix-newlines — set new line convention to DOS, MAC or Unix (default). Same as --group-separator with an appropriate string (e.g. --dos-newlines in bash is --group-sep $'\0').

careful, the manpage's own rendering of that last example is a lil cursed ($' and '$'0) floating around) — it's a $'…'-style string in bash, iykyk. 🫠

• --tsv-output, --csv-output, --adt-output — set separators for the TSV, CSV or ADT (ASCII delimited text, using ASCII GS, RS and US chars) output. Default is TSV output.
• --filename — print filename in the output.
• --no-filename — don't print filename in the output (default).
• --datablock-name, --dataname — print data block names in the output (default). 👑
• --no-datablock-name, --no-dataname — do not print data block names in the output.
• -d, --debug — print internal program data structures for debugging. for when you need to see the guts, ngl
• --version — print program version (SVN Id) and exit.
• --help — print short usage message (this message) and exit.

---

😭 REPORTING BUGS 😭

Report cifvalues bugs using e-mail: cod-bugs@ibt.lt

don't be shy, they wanna hear about it. bugs are just ✨unexpected features✨ until someone reports them.

---

and that's the whole page, bestie. it's filed as CIFVALUES(1) under the General Commands Manual — no fancy version string, no date stamp, just the manual name holding it down at the bottom like a true icon. slay, go extract some data values 💖✨🎀🦋🌸💅🫶