Scroll to navigation

GENDICT(1) ICU 72.1 Manual GENDICT(1)


gendict - Compiles word list into ICU string trie dictionary


gendict [ --uchars | --bytes --transform transform ] [ -h, -?, --help ] [ -V, --version ] [ -c, --copyright ] [ -v, --verbose ] [ -i, --icudatadir directory ] input-file output-file


gendict reads the word list from dictionary-file and creates a string trie dictionary file. Normally this data file has the .dict extension.

Words begin at the beginning of a line and are terminated by the first whitespace. Lines that begin with whitespace are ignored.


Print help about usage and exit.
Print the version of gendict and exit.
Embeds the standard ICU copyright into the output-file.
Display extra informative messages during execution.
Look for any necessary ICU data files in directory. For example, the file must be located when ICU's data is not built as a shared library. The default ICU data directory is specified by the environment variable ICU_DATA. Most configurations of ICU do not require this argument.
Set the output trie type to UChar. Mutually exclusive with --bytes.
Set the output trie type to Bytes. Mutually exclusive with --uchars.
Set the transform type. Should only be specified with --bytes. Currently supported transforms are: offset-<hex-number>, which specifies an offset to subtract from all input characters. It should be noted that the offset transform also maps U+200D to 0xFF and U+200C to 0xFE, in order to offer compatibility to languages that require these characters. A transform must be specified for a bytes trie, and when applied to the non-value characters in the input-file must produce output between 0x00 and 0xFF.
The source file to read.
The file to write the output dictionary to.


The input-file is assumed to be encoded in UTF-8. The integers in the input-file that are used as values must be made up of ASCII digits. They may be specified either in hex, by using a 0x prefix, or in decimal. Either --bytes or --uchars must be specified.


Specifies the directory containing ICU data. Defaults to ${prefix}/share/icu/72.1/. Some tools in ICU depend on the presence of the trailing slash. It is thus important to make sure that it is present if ICU_DATA is set.


Maxime Serrano




Copyright (C) 2012 International Business Machines Corporation and others


1 June 2012 ICU MANPAGE