farprintstrings(1)

📦
version 1.8.5 · 5 versions
, in ubuntu stonking

💖 farprintstrings — the manual, but make it cute

okay bestie, so farprintstrings is a lil command-line bestie from the OpenFst fam that lives in section 1 of the manual (the user-commands section, iykyk), and her whole thing is: she takes a finite-state archive and prints the FSTs inside it as strings. that's it. that's the job. she ate. 💅

✨ NAME ✨

farprintstrings — print FSTs in a finite-state archive as strings 🦋

🌸 SYNOPSIS 🌸

farprintstrings [OPTIONS] [in1.far in2.far...]

💜 DESCRIPTION 💜

So basically? She prints the FSTs in a finite-state archive as strings. That's the whole vibe. You hand her an archive, she hands you back strings. Main character energy fr fr. 👑

💅 OPTIONS 💅

okay before we get into the list: boolean options are chill like that — you can pass either true or false as the value, OR you can just say the option with no value at all and she'll assume true implicitly. no cap. 🫶

  • --begin_key=NAME — sets the first key to extract. Default: the first key in the archive. 🌈
  • --end_key=NAME — sets the last key to extract. Default: the last key in the archive. 🌈
  • --entry_type=TYPE — sets the entry type, and it's either file (one FST per file, so like, a whole file each) or line (one FST per line, the little guys). Default: line. ✨
  • --filename_prefix=STRING — sets the prefix to prepend to filenames. Default: no prefix. 🎀
  • --filename_suffix=STRING — sets the suffix to append to filenames. Default: no suffix. 🎀
  • --fst_align[=BOOLEAN] — write FST data aligned where appropriate. Default: false. 💫
  • --fst_compat_symbols[=BOOLEAN] — require symbol tables to match when appropriate. Default: true. 💫
  • --fst_default_cache_gc[=BOOLEAN] — enable garbage collection of cache (yes she does her own tidying, queen behaviour). Default: true. 🧚
  • --fst_default_cache_gc_limit=N — set the cache byte size that triggers garbage collection. Default: 1048576. 🔢
  • --fst_error_fatal[=BOOLEAN] — if true, FST errors are fatal. Otherwise, returned objects are flagged as bad. For example, FSTs are returned with the kError property set to true, and FST weights set so that Member() returns false. Default: true. 💀
  • --fst_field_separator=STRING — set the characters used as a separator between printed fields. Default: " ". 🍓
  • --fst_read_mode=STRING — set the default file reading mode for mappable files, either "read" or "map". Default: "read". 📖
  • --fst_verify_properties[=BOOLEAN] — verify fst properties queried by TestProperties. Default: false. 🔍
  • --fst_weight_parentheses=STRING — set the characters enclosing the first weight of a printed composite weight (e.g., pair weight, tuple weight, and derived classes) to ensure proper I/O of nested composite weights. Must have size 0 (none) or 2 (open and close parenthesis). Default: no parentheses. 🎁
  • --fst_weight_separator=CHARACTER — set the character separator between printed composite weights. Default: comma. 🍬
  • --generate_filenames=N — generate N digit numeric filenames. Default: use keys. 🔑
  • --help[=BOOLEAN] — show usage information. Default: false. 🙋
  • --helpshort[=BOOLEAN] — show brief usage information (the tl;dr version, obsessed). Default: false. 🙋
  • --initial-symbols[=BOOLEAN] — use the symbol table from the first FST in the archive for all entries. 🫶
  • --print_key[=BOOLEAN] — prefix each string by its key. Default: false. 🏷️
  • --print_weight[=BOOLEAN] — suffix each string by its weight. Default: false. ⚖️
  • --save_relabel_ipairs=FILENAME — save input relabel pairs to file. Default: do not save. 💾
  • --save_relabel_opairs=FILENAME — save output relabel pairs to file. Default: do not save. 💾
  • --symbols=FILENAME — read the label symbol table from a file. Default: do not read a table. 📂
  • --tmpdir=PATHNAME — set the temporary directory to use. Default: /tmp. 🗂️
  • --token_type=TYPE — set the token type, one of symbol, byte, or utf8. Default: symbol. 🔤
  • --v[=N] — set the verbosity level. Default: 0. 🔊

👀 SEE ALSO 👀

go read these too bestie, they're all in the same friend group:

okay that's the whole page, you're so welcome. 💖 this whole thing is living under OpenFst 1.8.5 and it was dated Mar 2026, so like, she's fresh. go print some strings, you got this. periodt. 👑✨🦋

📦 where this page comes from