.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH HFST-FST2STRINGS "1" "August 2018" "HFST" "User Commands"
.SH NAME
hfst-fst2strings \- =Display the strings recognized by a transducer
.SH SYNOPSIS
.B hfst-fst2strings
[\fI\,OPTIONS\/\fR...] [\fI\,INFILE\/\fR]
.SH DESCRIPTION
Display the strings recognized by a transducer
.SS "Common options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help message
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version info
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Print verbosely while processing
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Only print fatal erros and requested output
.TP
\fB\-s\fR, \fB\-\-silent\fR
Alias of \fB\-\-quiet\fR
.SS "Fst2strings options:"
.TP
\fB\-n\fR, \fB\-\-max\-strings\fR=\fI\,NSTR\/\fR
print at most NSTR strings
.TP
\fB\-N\fR, \fB\-\-nbest\fR=\fI\,NBEST\/\fR
print at most NBEST best strings
.TP
\fB\-r\fR, \fB\-\-random\fR=\fI\,NRAND\/\fR
print at most NRAND random strings
.TP
\fB\-c\fR, \fB\-\-cycles\fR=\fI\,NCYC\/\fR
follow cycles at most NCYC times
.TP
\fB\-w\fR, \fB\-\-print\-weights\fR
display the weight for each string
.TP
\fB\-S\fR, \fB\-\-print\-separator\fR
print separator "\-\-" after each transducer
.TP
\fB\-e\fR, \fB\-\-epsilon\-format\fR=\fI\,EPS\/\fR
print epsilon as EPS
.TP
\fB\-X\fR, \fB\-\-xfst\fR=\fI\,VARIABLE\/\fR
toggle xfst compatibility option VARIABLE
.SS "Ignore paths if:"
.TP
\fB\-b\fR, \fB\-\-beam\fR=\fI\,B\/\fR
output string weight not within B from the weight
of the best output string
.TP
\fB\-l\fR, \fB\-\-max\-in\-length\fR=\fI\,MIL\/\fR
input string longer than MIL
.TP
\fB\-L\fR, \fB\-\-max\-out\-length\fR=\fI\,MOL\/\fR
output string longer than MOL
.TP
\fB\-p\fR, \fB\-\-in\-prefix\fR=\fI\,OPREFIX\/\fR
input string not beginning with IPREFIX
.TP
\fB\-P\fR, \fB\-\-out\-prefix\fR=\fI\,OPREFIX\/\fR
output string not beginning with OPREFIX
.TP
\fB\-u\fR, \fB\-\-in\-exclude\fR=\fI\,IXSTR\/\fR
input string containing IXSTR
.TP
\fB\-U\fR, \fB\-\-out\-exclude\fR=\fI\,OXST\/\fR
output string containing OXSTR
.PP
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 }.
.SH EXAMPLES
.TP
hfst\-fst2strings lexical.hfst
generates all forms of lexical.hfst
.SS "Known bugs:"
.IP
Does not work correctly for hfst optimized lookup format.
.SH "REPORTING BUGS"
Report bugs to <hfst\-bugs@helsinki.fi> or directly to our bug tracker at:
<https://github.com/hfst/hfst/issues>
.PP
hfst\-fst2strings home page:
<https://kitwiki.csc.fi/twiki/bin/view/KitWiki//HfstFst2Strings>
.br
General help using HFST software:
<https://kitwiki.csc.fi/twiki/bin/view/KitWiki//HfstHome>
.SH COPYRIGHT
Copyright \(co 2017 University of Helsinki,
License GPLv3: GNU GPL version 3 <http://gnu.org/licenses/gpl.html>
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.