HFST-FST2STRINGS(1)

🦋 hfst-fst2strings(1) — bestie edition 🦋

okay so welcome to the hfst-fst2strings(1) manual page, the HFST one, and I'm gonna hold your hand through every single flag because you deserve that 💖 no cap, nothing is getting skipped.

---

✨ NAME ✨

hfst-fst2strings — and the original page says it does =Display the strings recognized by a transducer (the = is literally theirs, I'm keeping it, iykyk 💅). So: it shows you the strings your transducer recognizes. That's the whole job, and it eats.

---

🎀 SYNOPSIS 🎀

hfst-fst2strings [OPTIONS...] [INFILE]

---

🌸 DESCRIPTION 🌸

Display the strings recognized by a transducer. That's it, that's the vibe — you hand it a transducer, it hands you back the strings 💫

🌈 Common options:

• -h, --help — print the help message, the classic "what do I do now" button
• -V, --version — print version info
• -v, --verbose — print verbosely while processing, she's chatty
• -q, --quiet — only print fatal erros and requested output (yes, "erros" — the typo is in the original, we keep it, we don't touch the sacred texts 🙈)
• -s, --silent — alias of --quiet, same energy, different name

🔥 Fst2strings options:

• -n, --max-strings=NSTR — print at most NSTR strings
• -N, --nbest=NBEST — print at most NBEST best strings
• -r, --random=NRAND — print at most NRAND random strings
• -c, --cycles=NCYC — follow cycles at most NCYC times
• -w, --print-weights — display the weight for each string
• -S, --print-separator — print separator "--" after each transducer
• -e, --epsilon-format=EPS — print epsilon as EPS
• -X, --xfst=VARIABLE — toggle xfst compatibility option VARIABLE

💜 Ignore paths if:

• -b, --beam=B — output string weight not within B from the weight of the best output string
• -l, --max-in-length=MIL — input string longer than MIL
• -L, --max-out-length=MOL — output string longer than MOL
• -p, --in-prefix=OPREFIX — input string not beginning with IPREFIX
• -P, --out-prefix=OPREFIX — output string not beginning with OPREFIX
• -u, --in-exclude=IXSTR — input string containing IXSTR
• -U, --out-exclude=OXST — output string containing OXSTR

---

now the fine print, and bestie there is a LOT of fine print, so lock in 🔒

If OUTFILE or INFILE is missing or -, standard streams will be used. Format of result depends on format of INFILE. If all NSTR, NBEST and NCYC are omitted, all possible paths are printed: NSTR, NBEST and NCYC default to infinity. NBEST overrides NSTR and NCYC. NRAND overrides NBEST, NSTR and NCYC. B must be a non-negative float. If EPS is not given, default is empty string. Numeric options are parsed with strtod(3). Xfst variables supported are { obey-flags, print-flags, print-pairs, print-space, quote-special }.

⭐ real talk: those "ignore paths if" flags are filtering out paths, so read them as "throw this away when…", not "keep this when…". The wording above is straight from the source, no cap.

---

🧚 EXAMPLES 🧚

hfst-fst2strings lexical.hfst

generates all forms of lexical.hfst — iconic, honestly 👑

💀 Known bugs:

Does not work correctly for hfst optimized lookup format.

😭 yes, that's the bug, that's the whole bug, do not use it with hfst optimized lookup format and expect correct results.

---

🫶 REPORTING BUGS 🫶

Found something cursed? Report bugs to <hfst-bugs@helsinki.fi> or directly to our bug tracker at: <https://github.com/hfst/hfst/issues>

• hfst-fst2strings home page: <https://github.com/hfst/hfst/wiki/HfstFst2Strings>
• General help using HFST software: <https://github.com/hfst/hfst/wiki>

---

👑 COPYRIGHT 👑

Copyright © 2017 University of Helsinki, License GPLv3: GNU GPL version 3 <http://gnu.org/licenses/gpl.html>

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

🚨 NO WARRANTY bestie, it's free software, you can change it and share it, but if it explodes that's on you 💅

---

and that's the page!! brought to you by HFST, dated August 2018 — she's been serving this exact manual since then and she ate, fr fr 🌈✨🦋