/* Automatically generated file. Do not edit directly. */ /* This file is part of The New Aspell * Copyright (C) 2001-2002 by Kevin Atkinson under the GNU LGPL * license version 2.0 or 2.1. You should have received a copy of the * LGPL license along with this library if you did not you can find it * at http://www.gnu.org/. */ #ifndef ASPELL_ASPELL__H #define ASPELL_ASPELL__H #ifdef __cplusplus extern "C" { #endif /******************************* type id *******************************/ union AspellTypeId { unsigned int num; char str[4]; }; typedef union AspellTypeId AspellTypeId; /************************** mutable container **************************/ typedef struct AspellMutableContainer AspellMutableContainer; int aspell_mutable_container_add(struct AspellMutableContainer * ths, const char * to_add); int aspell_mutable_container_remove(struct AspellMutableContainer * ths, const char * to_rem); void aspell_mutable_container_clear(struct AspellMutableContainer * ths); struct AspellMutableContainer * aspell_mutable_container_to_mutable_container(struct AspellMutableContainer * ths); /******************************* key info *******************************/ enum AspellKeyInfoType {AspellKeyInfoString, AspellKeyInfoInt, AspellKeyInfoBool, AspellKeyInfoList}; typedef enum AspellKeyInfoType AspellKeyInfoType; struct AspellKeyInfo { /* the name of the key */ const char * name; /* the key type */ enum AspellKeyInfoType type; /* the default value of the key */ const char * def; /* a brief description of the key or null if internal value */ const char * desc; int flags; int other_data; }; typedef struct AspellKeyInfo AspellKeyInfo; /******************************** config ********************************/ typedef struct AspellKeyInfoEnumeration AspellKeyInfoEnumeration; int aspell_key_info_enumeration_at_end(const struct AspellKeyInfoEnumeration * ths); const struct AspellKeyInfo * aspell_key_info_enumeration_next(struct AspellKeyInfoEnumeration * ths); void delete_aspell_key_info_enumeration(struct AspellKeyInfoEnumeration * ths); struct AspellKeyInfoEnumeration * aspell_key_info_enumeration_clone(const struct AspellKeyInfoEnumeration * ths); void aspell_key_info_enumeration_assign(struct AspellKeyInfoEnumeration * ths, const struct AspellKeyInfoEnumeration * other); typedef struct AspellConfig AspellConfig; struct AspellConfig * new_aspell_config(); void delete_aspell_config(struct AspellConfig * ths); struct AspellConfig * aspell_config_clone(const struct AspellConfig * ths); void aspell_config_assign(struct AspellConfig * ths, const struct AspellConfig * other); unsigned int aspell_config_error_number(const struct AspellConfig * ths); const char * aspell_config_error_message(const struct AspellConfig * ths); const struct AspellError * aspell_config_error(const struct AspellConfig * ths); /* sets extra keys which this config class should accept * begin and end are expected to point to the begging * and end of an array of Aspell Key Info */ void aspell_config_set_extra(struct AspellConfig * ths, const struct AspellKeyInfo * begin, const struct AspellKeyInfo * end); /* returns the KeyInfo object for the * corresponding key or returns null and sets * error_num to PERROR_UNKNOWN_KEY if the key is * not valid. The pointer returned is valid for * the lifetime of the object. */ const struct AspellKeyInfo * aspell_config_keyinfo(struct AspellConfig * ths, const char * key); /* returns a newly allocated enumeration of all the * possible objects this config class uses */ struct AspellKeyInfoEnumeration * aspell_config_possible_elements(struct AspellConfig * ths, int include_extra); /* returns the default value for given key which * way involve substating variables, thus it is * not the same as keyinfo(key)->def returns null * and sets error_num to PERROR_UNKNOWN_KEY if * the key is not valid. Uses the temporary * string. */ const char * aspell_config_get_default(struct AspellConfig * ths, const char * key); /* returns a newly alloacted enumeration of all the * key/value pairs. This DOES not include ones * which are set to their default values */ struct AspellStringPairEnumeration * aspell_config_elements(struct AspellConfig * ths); /* inserts an item, if the item already exists it * will be replaced. returns true if it succesed * or false on error. If the key in not valid it * sets error_num to PERROR_UNKNOWN_KEY, if the * value is not valid it will sets error_num to * PERROR_BAD_VALUE, if the value can not be * changed it sets error_num to * PERROR_CANT_CHANGE_VALUE, and if the value is * a list and you are trying to set it directory * it sets error_num to PERROR_LIST_SET */ int aspell_config_replace(struct AspellConfig * ths, const char * key, const char * value); /* remove a key and returns true if it exists * otherise return false. This effictly sets the * key to its default value. Calling replace with * a value of "" will also call * remove. If the key does not exists sets * error_num to 0 or PERROR_NOT, if the key in * not valid sets error_num to * PERROR_UNKNOWN_KEY, if the value can not be * changed sets error_num to * PERROR_CANT_CHANGE_VALUE */ int aspell_config_remove(struct AspellConfig * ths, const char * key); int aspell_config_have(const struct AspellConfig * ths, const char * key); /* returns null on error */ const char * aspell_config_retrieve(struct AspellConfig * ths, const char * key); int aspell_config_retrieve_list(struct AspellConfig * ths, const char * key, struct AspellMutableContainer * lst); /* return -1 on error, 0 if false, 1 if true */ int aspell_config_retrieve_bool(struct AspellConfig * ths, const char * key); /* return -1 on error */ int aspell_config_retrieve_int(struct AspellConfig * ths, const char * key); /******************************** error ********************************/ struct AspellError { const char * mesg; const struct AspellErrorInfo * err; }; typedef struct AspellError AspellError; int aspell_error_is_a(const struct AspellError * ths, const struct AspellErrorInfo * e); struct AspellErrorInfo { const struct AspellErrorInfo * isa; const char * mesg; unsigned int num_parms; const char * parms[3]; }; typedef struct AspellErrorInfo AspellErrorInfo; /**************************** can have error ****************************/ typedef struct AspellCanHaveError AspellCanHaveError; unsigned int aspell_error_number(const struct AspellCanHaveError * ths); const char * aspell_error_message(const struct AspellCanHaveError * ths); const struct AspellError * aspell_error(const struct AspellCanHaveError * ths); void delete_aspell_can_have_error(struct AspellCanHaveError * ths); /******************************** errors ********************************/ extern const struct AspellErrorInfo * const aerror_other; extern const struct AspellErrorInfo * const aerror_operation_not_supported; extern const struct AspellErrorInfo * const aerror_cant_copy; extern const struct AspellErrorInfo * const aerror_unimplemented_method; extern const struct AspellErrorInfo * const aerror_file; extern const struct AspellErrorInfo * const aerror_cant_open_file; extern const struct AspellErrorInfo * const aerror_cant_read_file; extern const struct AspellErrorInfo * const aerror_cant_write_file; extern const struct AspellErrorInfo * const aerror_invalid_name; extern const struct AspellErrorInfo * const aerror_bad_file_format; extern const struct AspellErrorInfo * const aerror_dir; extern const struct AspellErrorInfo * const aerror_cant_read_dir; extern const struct AspellErrorInfo * const aerror_config; extern const struct AspellErrorInfo * const aerror_unknown_key; extern const struct AspellErrorInfo * const aerror_cant_change_value; extern const struct AspellErrorInfo * const aerror_bad_key; extern const struct AspellErrorInfo * const aerror_bad_value; extern const struct AspellErrorInfo * const aerror_duplicate; extern const struct AspellErrorInfo * const aerror_key_not_string; extern const struct AspellErrorInfo * const aerror_key_not_int; extern const struct AspellErrorInfo * const aerror_key_not_bool; extern const struct AspellErrorInfo * const aerror_key_not_list; extern const struct AspellErrorInfo * const aerror_no_value_reset; extern const struct AspellErrorInfo * const aerror_no_value_enable; extern const struct AspellErrorInfo * const aerror_no_value_disable; extern const struct AspellErrorInfo * const aerror_no_value_clear; extern const struct AspellErrorInfo * const aerror_language_related; extern const struct AspellErrorInfo * const aerror_unknown_language; extern const struct AspellErrorInfo * const aerror_unknown_soundslike; extern const struct AspellErrorInfo * const aerror_language_not_supported; extern const struct AspellErrorInfo * const aerror_no_wordlist_for_lang; extern const struct AspellErrorInfo * const aerror_mismatched_language; extern const struct AspellErrorInfo * const aerror_affix; extern const struct AspellErrorInfo * const aerror_corrupt_affix; extern const struct AspellErrorInfo * const aerror_invalid_cond; extern const struct AspellErrorInfo * const aerror_invalid_cond_strip; extern const struct AspellErrorInfo * const aerror_incorrect_encoding; extern const struct AspellErrorInfo * const aerror_encoding; extern const struct AspellErrorInfo * const aerror_unknown_encoding; extern const struct AspellErrorInfo * const aerror_encoding_not_supported; extern const struct AspellErrorInfo * const aerror_conversion_not_supported; extern const struct AspellErrorInfo * const aerror_pipe; extern const struct AspellErrorInfo * const aerror_cant_create_pipe; extern const struct AspellErrorInfo * const aerror_process_died; extern const struct AspellErrorInfo * const aerror_bad_input; extern const struct AspellErrorInfo * const aerror_invalid_string; extern const struct AspellErrorInfo * const aerror_invalid_word; extern const struct AspellErrorInfo * const aerror_invalid_affix; extern const struct AspellErrorInfo * const aerror_inapplicable_affix; extern const struct AspellErrorInfo * const aerror_unknown_unichar; extern const struct AspellErrorInfo * const aerror_word_list_flags; extern const struct AspellErrorInfo * const aerror_invalid_flag; extern const struct AspellErrorInfo * const aerror_conflicting_flags; extern const struct AspellErrorInfo * const aerror_version_control; extern const struct AspellErrorInfo * const aerror_bad_version_string; extern const struct AspellErrorInfo * const aerror_filter; extern const struct AspellErrorInfo * const aerror_cant_dlopen_file; extern const struct AspellErrorInfo * const aerror_empty_filter; extern const struct AspellErrorInfo * const aerror_no_such_filter; extern const struct AspellErrorInfo * const aerror_confusing_version; extern const struct AspellErrorInfo * const aerror_bad_version; extern const struct AspellErrorInfo * const aerror_identical_option; extern const struct AspellErrorInfo * const aerror_options_only; extern const struct AspellErrorInfo * const aerror_invalid_option_modifier; extern const struct AspellErrorInfo * const aerror_cant_describe_filter; extern const struct AspellErrorInfo * const aerror_filter_mode_file; extern const struct AspellErrorInfo * const aerror_mode_option_name; extern const struct AspellErrorInfo * const aerror_no_filter_to_option; extern const struct AspellErrorInfo * const aerror_bad_mode_key; extern const struct AspellErrorInfo * const aerror_expect_mode_key; extern const struct AspellErrorInfo * const aerror_mode_version_requirement; extern const struct AspellErrorInfo * const aerror_confusing_mode_version; extern const struct AspellErrorInfo * const aerror_bad_mode_version; extern const struct AspellErrorInfo * const aerror_missing_magic_expression; extern const struct AspellErrorInfo * const aerror_empty_file_ext; extern const struct AspellErrorInfo * const aerror_filter_mode_expand; extern const struct AspellErrorInfo * const aerror_unknown_mode; extern const struct AspellErrorInfo * const aerror_mode_extend_expand; extern const struct AspellErrorInfo * const aerror_filter_mode_magic; extern const struct AspellErrorInfo * const aerror_file_magic_pos; extern const struct AspellErrorInfo * const aerror_file_magic_range; extern const struct AspellErrorInfo * const aerror_missing_magic; extern const struct AspellErrorInfo * const aerror_bad_magic; extern const struct AspellErrorInfo * const aerror_expression; extern const struct AspellErrorInfo * const aerror_invalid_expression; /******************************* speller *******************************/ typedef struct AspellSpeller AspellSpeller; struct AspellCanHaveError * new_aspell_speller(struct AspellConfig * config); struct AspellSpeller * to_aspell_speller(struct AspellCanHaveError * obj); void delete_aspell_speller(struct AspellSpeller * ths); unsigned int aspell_speller_error_number(const struct AspellSpeller * ths); const char * aspell_speller_error_message(const struct AspellSpeller * ths); const struct AspellError * aspell_speller_error(const struct AspellSpeller * ths); struct AspellConfig * aspell_speller_config(struct AspellSpeller * ths); /* returns 0 if it is not in the dictionary, * 1 if it is, or -1 on error. */ int aspell_speller_check(struct AspellSpeller * ths, const char * word, int word_size); int aspell_speller_add_to_personal(struct AspellSpeller * ths, const char * word, int word_size); int aspell_speller_add_to_session(struct AspellSpeller * ths, const char * word, int word_size); const struct AspellWordList * aspell_speller_personal_word_list(struct AspellSpeller * ths); const struct AspellWordList * aspell_speller_session_word_list(struct AspellSpeller * ths); const struct AspellWordList * aspell_speller_main_word_list(struct AspellSpeller * ths); int aspell_speller_save_all_word_lists(struct AspellSpeller * ths); int aspell_speller_clear_session(struct AspellSpeller * ths); /* Return null on error. * the word list returned by suggest is only valid until the next * call to suggest */ const struct AspellWordList * aspell_speller_suggest(struct AspellSpeller * ths, const char * word, int word_size); int aspell_speller_store_replacement(struct AspellSpeller * ths, const char * mis, int mis_size, const char * cor, int cor_size); /******************************** filter ********************************/ typedef struct AspellFilter AspellFilter; void delete_aspell_filter(struct AspellFilter * ths); unsigned int aspell_filter_error_number(const struct AspellFilter * ths); const char * aspell_filter_error_message(const struct AspellFilter * ths); const struct AspellError * aspell_filter_error(const struct AspellFilter * ths); struct AspellFilter * to_aspell_filter(struct AspellCanHaveError * obj); /*************************** document checker ***************************/ struct AspellToken { unsigned int offset; unsigned int len; }; typedef struct AspellToken AspellToken; typedef struct AspellDocumentChecker AspellDocumentChecker; void delete_aspell_document_checker(struct AspellDocumentChecker * ths); unsigned int aspell_document_checker_error_number(const struct AspellDocumentChecker * ths); const char * aspell_document_checker_error_message(const struct AspellDocumentChecker * ths); const struct AspellError * aspell_document_checker_error(const struct AspellDocumentChecker * ths); /* Creates a new document checker. * The speller class is expect to last until this * class is destroyed. * If config is given it will be used to overwide * any relevent options set by this speller class. * The config class is not once this function is done. * If filter is given then it will take ownership of * the filter class and use it to do the filtering. * You are expected to free the checker when done. */ struct AspellCanHaveError * new_aspell_document_checker(struct AspellSpeller * speller); struct AspellDocumentChecker * to_aspell_document_checker(struct AspellCanHaveError * obj); /* reset the internal state of the filter. * should be called whenever a new document is being filtered */ void aspell_document_checker_reset(struct AspellDocumentChecker * ths); /* process a string * The string passed in should only be split on white space * characters. Furthermore, between calles to reset, each string * should be passed in exactly once and in the order they appeared * in the document. Passing in stings out of order, skipping * strings or passing them in more than once may lead to undefined * results. */ void aspell_document_checker_process(struct AspellDocumentChecker * ths, const char * str, int size); /* returns the next misspelled word in the processed string * if there are no more misspelled word than token.word * will be null and token.size will be 0 */ struct AspellToken aspell_document_checker_next_misspelling(struct AspellDocumentChecker * ths); /* returns the underlying filter class */ struct AspellFilter * aspell_document_checker_filter(struct AspellDocumentChecker * ths); /****************************** word list ******************************/ typedef struct AspellWordList AspellWordList; int aspell_word_list_empty(const struct AspellWordList * ths); unsigned int aspell_word_list_size(const struct AspellWordList * ths); struct AspellStringEnumeration * aspell_word_list_elements(const struct AspellWordList * ths); /************************** string enumeration **************************/ typedef struct AspellStringEnumeration AspellStringEnumeration; void delete_aspell_string_enumeration(struct AspellStringEnumeration * ths); struct AspellStringEnumeration * aspell_string_enumeration_clone(const struct AspellStringEnumeration * ths); void aspell_string_enumeration_assign(struct AspellStringEnumeration * ths, const struct AspellStringEnumeration * other); int aspell_string_enumeration_at_end(const struct AspellStringEnumeration * ths); const char * aspell_string_enumeration_next(struct AspellStringEnumeration * ths); /********************************* info *********************************/ struct AspellModuleInfo { const char * name; double order_num; const char * lib_dir; struct AspellStringList * dict_dirs; struct AspellStringList * dict_exts; }; typedef struct AspellModuleInfo AspellModuleInfo; struct AspellDictInfo { /* name to identify the dictionary by */ const char * name; const char * code; const char * jargon; int size; const char * size_str; struct AspellModuleInfo * module; }; typedef struct AspellDictInfo AspellDictInfo; typedef struct AspellModuleInfoList AspellModuleInfoList; struct AspellModuleInfoList * get_aspell_module_info_list(struct AspellConfig * config); int aspell_module_info_list_empty(const struct AspellModuleInfoList * ths); unsigned int aspell_module_info_list_size(const struct AspellModuleInfoList * ths); struct AspellModuleInfoEnumeration * aspell_module_info_list_elements(const struct AspellModuleInfoList * ths); typedef struct AspellDictInfoList AspellDictInfoList; struct AspellDictInfoList * get_aspell_dict_info_list(struct AspellConfig * config); int aspell_dict_info_list_empty(const struct AspellDictInfoList * ths); unsigned int aspell_dict_info_list_size(const struct AspellDictInfoList * ths); struct AspellDictInfoEnumeration * aspell_dict_info_list_elements(const struct AspellDictInfoList * ths); typedef struct AspellModuleInfoEnumeration AspellModuleInfoEnumeration; int aspell_module_info_enumeration_at_end(const struct AspellModuleInfoEnumeration * ths); const struct AspellModuleInfo * aspell_module_info_enumeration_next(struct AspellModuleInfoEnumeration * ths); void delete_aspell_module_info_enumeration(struct AspellModuleInfoEnumeration * ths); struct AspellModuleInfoEnumeration * aspell_module_info_enumeration_clone(const struct AspellModuleInfoEnumeration * ths); void aspell_module_info_enumeration_assign(struct AspellModuleInfoEnumeration * ths, const struct AspellModuleInfoEnumeration * other); typedef struct AspellDictInfoEnumeration AspellDictInfoEnumeration; int aspell_dict_info_enumeration_at_end(const struct AspellDictInfoEnumeration * ths); const struct AspellDictInfo * aspell_dict_info_enumeration_next(struct AspellDictInfoEnumeration * ths); void delete_aspell_dict_info_enumeration(struct AspellDictInfoEnumeration * ths); struct AspellDictInfoEnumeration * aspell_dict_info_enumeration_clone(const struct AspellDictInfoEnumeration * ths); void aspell_dict_info_enumeration_assign(struct AspellDictInfoEnumeration * ths, const struct AspellDictInfoEnumeration * other); /***************************** string list *****************************/ typedef struct AspellStringList AspellStringList; struct AspellStringList * new_aspell_string_list(); int aspell_string_list_empty(const struct AspellStringList * ths); unsigned int aspell_string_list_size(const struct AspellStringList * ths); struct AspellStringEnumeration * aspell_string_list_elements(const struct AspellStringList * ths); int aspell_string_list_add(struct AspellStringList * ths, const char * to_add); int aspell_string_list_remove(struct AspellStringList * ths, const char * to_rem); void aspell_string_list_clear(struct AspellStringList * ths); struct AspellMutableContainer * aspell_string_list_to_mutable_container(struct AspellStringList * ths); void delete_aspell_string_list(struct AspellStringList * ths); struct AspellStringList * aspell_string_list_clone(const struct AspellStringList * ths); void aspell_string_list_assign(struct AspellStringList * ths, const struct AspellStringList * other); /****************************** string map ******************************/ typedef struct AspellStringMap AspellStringMap; struct AspellStringMap * new_aspell_string_map(); int aspell_string_map_add(struct AspellStringMap * ths, const char * to_add); int aspell_string_map_remove(struct AspellStringMap * ths, const char * to_rem); void aspell_string_map_clear(struct AspellStringMap * ths); struct AspellMutableContainer * aspell_string_map_to_mutable_container(struct AspellStringMap * ths); void delete_aspell_string_map(struct AspellStringMap * ths); struct AspellStringMap * aspell_string_map_clone(const struct AspellStringMap * ths); void aspell_string_map_assign(struct AspellStringMap * ths, const struct AspellStringMap * other); int aspell_string_map_empty(const struct AspellStringMap * ths); unsigned int aspell_string_map_size(const struct AspellStringMap * ths); struct AspellStringPairEnumeration * aspell_string_map_elements(const struct AspellStringMap * ths); /* Insert a new element. * Will NOT overright an existing entry. * Returns false if the element already exists. */ int aspell_string_map_insert(struct AspellStringMap * ths, const char * key, const char * value); /* Insert a new element. * Will overright an existing entry. * Always returns true. */ int aspell_string_map_replace(struct AspellStringMap * ths, const char * key, const char * value); /* Looks up an element. * Returns null if the element did not exist. * Returns an empty string if the element exists but has a null value. * Otherwises returns the value */ const char * aspell_string_map_lookup(const struct AspellStringMap * ths, const char * key); /***************************** string pair *****************************/ struct AspellStringPair { const char * first; const char * second; }; typedef struct AspellStringPair AspellStringPair; /*********************** string pair enumeration ***********************/ typedef struct AspellStringPairEnumeration AspellStringPairEnumeration; int aspell_string_pair_enumeration_at_end(const struct AspellStringPairEnumeration * ths); struct AspellStringPair aspell_string_pair_enumeration_next(struct AspellStringPairEnumeration * ths); void delete_aspell_string_pair_enumeration(struct AspellStringPairEnumeration * ths); struct AspellStringPairEnumeration * aspell_string_pair_enumeration_clone(const struct AspellStringPairEnumeration * ths); void aspell_string_pair_enumeration_assign(struct AspellStringPairEnumeration * ths, const struct AspellStringPairEnumeration * other); /******************************** cache ********************************/ /* Reset the global cache(s) so that cache queries will create a new * object. If exiting objects are still in use they are not deleted. * If which is NULL than ALL caches will be reset. Current caches are * "encode", "decode", "dictionary", "language", and "keyboard". */ int aspell_reset_cache(const char * which); #ifdef __cplusplus } #endif #endif /* ASPELL_ASPELL__H */