ESpellDictionary: Evolution Utilities Reference Manual

## ESpellDictionary ESpellDictionary |

## Functions

ESpellDictionary * | e_spell_dictionary_new ()
ESpellDictionary * | e_spell_dictionary_new_bare ()
guint | e_spell_dictionary_hash ()
gboolean | e_spell_dictionary_equal ()
gint | e_spell_dictionary_compare ()
const gchar * | e_spell_dictionary_get_name ()
const gchar * | e_spell_dictionary_get_code ()
struct _ESpellChecker * | e_spell_dictionary_ref_spell_checker ()
gboolean | e_spell_dictionary_check_word ()
void | e_spell_dictionary_learn_word ()
void | e_spell_dictionary_ignore_word ()
GList * | e_spell_dictionary_get_suggestions ()
void | e_spell_dictionary_store_correction ()

## Properties

ESpellChecker * | spell-checker | Read / Write / Construct Only

## Object Hierarchy

        GObject
        ╰── ESpellDictionary

## Description

## Functions

### e_spell_dictionary_new ()

    ESpellDictionary *
    e_spell_dictionary_new (struct _ESpellChecker *spell_checker,
                            gpointer enchant_dict);

### e_spell_dictionary_new_bare ()

    ESpellDictionary *
    e_spell_dictionary_new_bare (struct _ESpellChecker *spell_checker,
                                 const gchar *language_tag);

### e_spell_dictionary_hash ()

    guint
    e_spell_dictionary_hash (ESpellDictionary *dictionary);

Generates a hash value for `dictionary` based on its ISO code. This function is intended for easily hashing an ESpellDictionary to add to a GHashTable or similar data structure.

#### Parameters

dictionary | an ESpellDictionary |

#### Returns

a hash value for `dictionary`

### e_spell_dictionary_equal ()

    gboolean
    e_spell_dictionary_equal (ESpellDictionary *dictionary1,
                              ESpellDictionary *dictionary2);

Checks two ESpellDictionary instances for equality based on their ISO codes.

#### Parameters

dictionary1 | an ESpellDictionary |
dictionary2 | another ESpellDictionary |

#### Returns

`TRUE` if `dictionary1` and `dictionary2` are equal

### e_spell_dictionary_compare ()

    gint
    e_spell_dictionary_compare (ESpellDictionary *dictionary1,
                                ESpellDictionary *dictionary2);

Compares `dictionary1` and `dictionary2` by their display names for the purpose of lexicographical sorting. Use this function where a GCompareFunc callback is required, such as `g_list_sort()`.

#### Parameters

dictionary1 | an ESpellDictionary |
dictionary2 | another ESpellDictionary |

#### Returns

0 if the names match, a negative value if `dictionary1` < `dictionary2` , or a positive value of `dictionary1` > `dictionary2`

### e_spell_dictionary_get_name ()

    const gchar *
    e_spell_dictionary_get_name (ESpellDictionary *dictionary);

Returns the display name of the dictionary (for example "English (British)")

#### Parameters

dictionary | an ESpellDictionary |

#### Returns

the display name of the `dictionary`

### e_spell_dictionary_get_code ()

    const gchar *
    e_spell_dictionary_get_code (ESpellDictionary *dictionary);

Returns the ISO code of the spell-checking language for `dictionary` (for example "en_US").

#### Parameters

dictionary | an ESpellDictionary |

#### Returns

the language code of the `dictionary`

### e_spell_dictionary_ref_spell_checker ()

    struct _ESpellChecker *
    e_spell_dictionary_ref_spell_checker (ESpellDictionary *dictionary);

Returns a new reference to the ESpellChecker which owns the dictionary. Unreference the ESpellChecker with `g_object_unref()` when finished with it.

#### Parameters

dictionary | an ESpellDictionary |

#### Returns

an ESpellChecker

### e_spell_dictionary_check_word ()

    gboolean
    e_spell_dictionary_check_word (ESpellDictionary *dictionary,
                                   const gchar *word,
                                   gsize length);

Tries to lookup the `word` in the `dictionary` to check whether it's spelled correctly or not.

#### Parameters

dictionary | an ESpellDictionary |
word | a word to spell-check |
length | length of `word` in bytes or -1 when `NULL`-terminated |

#### Returns

`TRUE` if `word` is recognized, `FALSE` otherwise

### e_spell_dictionary_learn_word ()

    void
    e_spell_dictionary_learn_word (ESpellDictionary *dictionary,
                                   const gchar *word,
                                   gsize length);

Permanently adds `word` to `dictionary` so that next time calling `e_spell_dictionary_check()` on the `word` will return `TRUE`.

#### Parameters

dictionary | an ESpellDictionary |
word | a word to add to `dictionary` |
length | length of `word` in bytes or -1 when `NULL`-terminated |

### e_spell_dictionary_ignore_word ()

    void
    e_spell_dictionary_ignore_word (ESpellDictionary *dictionary,
                                    const gchar *word,
                                    gsize length);

Adds `word` to temporary ignore list of the `dictionary` , so that `e_spell_dictionary_check()` on the `word` will return `TRUE`. The list is cleared when the dictionary is freed.

#### Parameters

dictionary | an ESpellDictionary |
word | a word to add to ignore list |
length | length of `word` in bytes or -1 when `NULL`-terminated |

### e_spell_dictionary_get_suggestions ()

    GList *
    e_spell_dictionary_get_suggestions (ESpellDictionary *dictionary,
                                        const gchar *word,
                                        gsize length);

Provides list of alternative spellings of `word` .

Free the returned spelling suggestions with `g_free()`, and the list itself with `g_list_free()`. An easy way to free the list properly in one step is as follows:

    1
    g_list_free_full (list, (GDestroyNotify) g_free);

#### Parameters

dictionary | an ESpellDictionary |
word | a word to which to find suggestions |
length | length of `word` in bytes or -1 when `NULL`-terminated |

#### Returns

a list of spelling suggestions for `word`

### e_spell_dictionary_store_correction ()

    void
    e_spell_dictionary_store_correction (ESpellDictionary *dictionary,
                                         const gchar *misspelled,
                                         gsize misspelled_length,
                                         const gchar *correction,
                                         gsize correction_length);

## Property Details

### The `“spell-checker”` property

      “spell-checker”            ESpellChecker *

Parent spell checker.

Owner: ESpellDictionary

Flags: Read / Write / Construct Only