---
name: "farcompilestrings"
section: "1"
platform: "linux"
package: "libfst-tools"
version: "1.8.4-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/farcompilestrings"
---

# farcompilestrings(1)

store compiled FSTs in a finite-state archive

## NAME

farcompilestrings - store compiled FSTs in a finite-state archive

## SYNOPSIS

**farcompilestrings** \[*OPTIONS*\] \[*in1.txt* \[\[*in2.txt* ...\] *out.far*\]\]

## DESCRIPTION

Compiles a set of strings as FSTs and stores them in a finite-state archive.

## OPTIONS

Boolean options accept either *true* or *false* as a value, or the implicit value *true* if neither value is specified.

- **--allow\_negative\_labels**\[=*BOOLEAN*\]

  Allow negative labels (not recommended; may cause conflicts).  Default: false.

- **--arc\_type**=*TYPE*

  Set the output arc type.  Default: standard.

- **--entry\_type**=*TYPE*

  Set the entry type, either *file* (one FST per file) or *line* (one FST per line).  Default: line.

- **--far\_type**=*TYPE*

  Set the FAR file format, one of *default*, *fst*, *stlist*, or *sttable*.  Default: default.

- **--file\_list\_input**\[=*BOOLEAN*\]

  Each input file contains a list of files to be processed.  Default: false.

- **--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.  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\_type=***TYPE*

  **Set the output FST type.  Default: vector.**

- **--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\_keys=***N*

  **Generate N digit numeric keys.  Default: use file basenames.**

- **--help\[=***BOOLEAN***\]**

  **Show usage information.  Default: false.**

- **--helpshort\[=***BOOLEAN***\]**

  **Show brief usage information.  Default: false.**

- **--initial-symbols\[=***BOOLEAN***\]**

  **If --keep-symbols is true, store the symbol table for only the first FST in** **the archive.  Default: true.**

- **--keep-symbols\[=***BOOLEAN***\]**

  **Store the symbol table in the FAR file.  Default: false.**

- **--key\_prefix=***STRING*

  **Set the prefix to prepend to keys.  Default: no prefix.**

- **--key\_suffix=***STRING*

  **Set the suffix to append to keys.  Default: no suffix.**

- **--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***.**

- **--unknown-symbol=***STRING*

  **String to substitute for an unknown symbol.**

- **--v\[=***N***\]**

  **Set the verbosity level.  Default: 0.**

## SEE ALSO

*farcreate***(1),** *farequal***(1),** *farextract***(1),** *farinfo***(1),** *farisomorphic***(1),** *farprintstrings***(1)**