Reads a word list from a file.
int ReadHWL( HWL hwl, HFILE hfile )
A handle to an empty word list.
A handle to a file previously opened for reading.
Returns HRCR_OK if successful; otherwise, returns one of the following
||Invalid parameter or file or other error.
The words are expected as ANSI text, one word per line, followed by a carriage
return and linefeed. In this context, a word can represent a phrase and
contain spaces or other noncharacters, such as "New York" and "ne'er-do-well." Empty
lines or lines containing only spaces or tabs are allowed but ignored.
The file that hfile
refers to must already exist and be open for reading.
parameter must be the handle of an empty word list created by CreateHWL
. If the word list is not empty, ReadHWL
Once the file is read, it can be closed immediately.
The following example demonstrates how to provide a word list to constrain
recognition results to the words contained in the fictitious file COUNTRY.LST:
HWL hwlCountries = CreateHWL( NULL, NULL, WLT_EMPTY, 0L );
HFILE hfile = OpenFile( "country.lst", &ofStruct, OF_READ );
if (hfile != HFILE_ERROR)
if (hrc = CreateCompatibleHRC( NULL, NULL ))
SetWordlistHRC( hrc, hwlCountries ); // Set list into HRC
SetWordlistCoercionHRC( hrc, SCH_FORCE ); // Force match
. // Code that collects and recognizes input here
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages