cnvtool command syntax in Character conversion plug-in creation tools reference

The cnvtool utility creates a C++ file which contains the character set conversion data (in an SCnvConversionData struct) and optionally a function returning the replacement for unconvertible Unicode characters. Both are used in a plug-in character conversion DLL.

Invocation syntax

cnvtool -generateSourceCode control-file source-file output-file [options]

Arguments

`-generateSourceCode`	This should always be specified.
control-file	The filename of the control file.
source-file	The filename of the source text file.
output-file	The filename of the generated cpp file.
[`options`]	See table below.

The optional arguments may be positioned anywhere in the parameter list. Each has a short and a long form, shown in the table below separated by a '|'.

`-c` \| `-columns`(number-of-columns: column-of-foreign-character-set-codes, column-of-Unicode-codes)	This should be used if the source file consists of a non-standard number of columns, or if the columns are in a non-standard order. 1 (rather than 0) is the first column. If this flag is not used, then `-columns(2: 1, 2)` is assumed.
`-r \| -omitReplacementForUnconvertibleUnicodeCharacters`	This should be specified if the replacement for unconvertible Unicode characters specified in the control file is not going to be used by the plug-in DLL.
`-p \| -cutOutAnyPrivateUseUnicodeCharacterSlotsBeingUsed`	If this is not used and one or more private-use Unicode character slots are being used, a warning is generated.
`-u \| -sourceFilesToSubtract` (source-file-1, source-file-2, ...)	This is for use when only a subset of the source file is to be used; the conversion pairs contained in the source files listed under this flag being subtracted from the conversion pairs obtained from the actual source file.