respell_init(), respell

respell_init(), respell_winit()

extern KADMOS_ERROR KADMOS_API respell_init
(ReSpellData *rsd, const char *file_title);

        extern KADMOS_ERROR KADMOS_API respell_winit
(ReSpellData *rsd, const wchar_t *file_title);

Parameter:

rsd: Pointer to a with respell_init() initialized structure ReSpellData.
file_title: String with the name of the requested dictionary file (*.hash).

Return value:

RE_SUCCESS or KADMOS error type.

Comment:

The function loads the dictionary file, specified by dictionary, for subsequent calls of respell_do() and respell_filetitle(). The dictionary is unloaded by a call of respell_end(). For the call of respell_init() only the sub structure ReSpellInit in the ReSpellData structure has to be set, except the values of interna1, interna2, and interna3. The values of interna1, interna2, and interna3 will be set to handles or pointers of the loaded dictionary data, and must not be changed before respell_end() has been called. In case of success the function returns RE_SUCCESS, in case of error it returns the related error type. The error text can be retrieved by calling re_GetErrorText() or be displayed by calling re_DisplayErrorText().