fstprint(1)

📦
version 1.8.5 · 5 versions
, in ubuntu stonking

👑 fstprint — the glow-up your FST deserves 💅

okay bestie, so fstprint is a little icon from the User Commands collection and she has ONE job: take your binary FST and print it out in simple text format. that's it. that's the whole vibe. she eats every time. ✨

✨ SYNOPSIS ✨

fstprint [OPTIONS] [binary.fst [text.fst]]

literally just hand her your options and your files and she'll handle it 🫶

🌸 DESCRIPTION 🌸

Prints out binary FSTs in simple text format. no cap, that's the entire description. she's a one-trick pony and the trick is iconic. 🦋

🎀 OPTIONS 🎀

quick heads up before we get into it, bestie: Boolean options accept either true or false as a value, or the implicit value true if neither value is specified. so like, if you're feeling lazy you can just say the flag and it'll assume true. periodt. 💖

  • --acceptor[=BOOLEAN] — treats the input as being in acceptor format. Default: false. 🎀
  • --allow_negative_labels[=BOOLEAN] — lets negative labels through. not recommended, and it may cause conflicts!! Default: false. 💀
  • --fst_align[=BOOLEAN] — writes FST data aligned, where appropriate. Default: false. ✨
  • --fst_compat_symbols[=BOOLEAN] — requires symbol tables to match, when appropriate. Default: true. 🔥
  • --fst_default_cache_gc[=BOOLEAN] — turns on garbage collection of the cache. Default: true. 🧚
  • --fst_default_cache_gc_limit=N — sets the cache byte size that triggers garbage collection. Default: 1048576. 🍓
  • --fst_error_fatal[=BOOLEAN] — if this is true, FST errors are fatal. otherwise, the returned objects get flagged as bad — like, FSTs come back with the kError property set to true, and FST weights get set so that Member() returns false. Default: true. 😭
  • --fst_field_separator=STRING — sets the characters used as a separator between printed fields. Default: " ". 🌈
  • --fst_read_mode=STRING — sets the default file reading mode for mappable files, and it's either "read" or "map". Default: "read". 👑
  • --fst_verify_properties[=BOOLEAN] — verifies the fst properties queried by TestProperties. Default: false. ⭐
  • --fst_weight_parentheses=STRING — sets the characters enclosing the first weight of a printed composite weight (think pair weight, tuple weight, and derived classes) so that nested composite weights get proper I/O. must have size 0 (none) or 2 (open and close parenthesis). Default: no parentheses. 💜
  • --fst_weight_separator=CHARACTER — sets the character separator between printed composite weights. Default: comma. 🎀
  • --help[=BOOLEAN] — shows usage information. Default: false. 🫶
  • --helpshort[=BOOLEAN] — shows brief usage information. Default: false. ✨
  • --isymbols=FILENAME — sets the input label symbol table. Default: "". 🦋
  • --missing-symbol=CHARACTER — the symbol to print when a lookup fails. Default: raise an error. 😭
  • --numeric[=BOOLEAN] — prints numeric labels. Default: false. 🔢
  • --osymbols=FILENAME — sets the output label symbol table. Default: "". 🌸
  • --save_isymbols=FILENAME — saves the input symbol table to a file. Default: do not write a table. 💾
  • --save_osymbols=FILENAME — saves the output symbol table to a file. Default: do not write a table. 💾
  • --save_relabel_ipairs=FILENAME — saves input relabel pairs to a file. Default: do not save. 🎀
  • --save_relabel_opairs=FILENAME — saves output relabel pairs to a file. Default: do not save. 🎀
  • --show_weight_one[=BOOLEAN] — prints/draws arc weights and final weights equal to semiring One. Default: false. 🌟
  • --ssymbols=FILENAME — sets the state label symbol table. Default: "". 🦋
  • --tmpdir=PATHNAME — sets the temporary directory to use. Default: /tmp. 📁
  • --v[=N] — sets the verbosity level. Default: 0. 🗣️

🌈 SEE ALSO 🌈

the whole friend group fr fr, go say hi to all of them:

fstarcsort(1), fstclosure(1), fstcompile(1), fstcompose(1), fstcompress(1), fstconcat(1), fstconnect(1), fstconvert(1), fstdeterminize(1), fstdifference(1), fstdisambiguate(1), fstdraw(1), fstencode(1), fstepsnormalize(1), fstequal(1), fstequivalent(1), fstinfo(1), fstintersect(1), fstinvert(1), fstisomorphic(1), fstlinear(1), fstloglinearapply(1), fstmap(1), fstminimize(1), fstproject(1), fstprune(1), fstpush(1), fstrandgen(1), fstrelabel(1), fstreplace(1), fstreverse(1), fstreweight(1), fstrmepsilon(1), fstshortestdistance(1), fstshortestpath(1), fstsymbols(1), fstsynchronize(1), fsttopsort(1), fstunion(1)

oh and before you go — this whole page is OpenFst 1.8.5, and she was born in Mar 2026. tell her she looks gorgeous today. bye bestie, go print some FSTs 💖✨🦋
📦 where this page comes from