[evolution/webkit-composer: 123/147] Add e_spell_checker_list_active_languages()

[Matthew Barnes <mbarnes src gnome org>]

commit 1919986daf0dedd50ac45e978047f86b3895e0f3
Author: Matthew Barnes <mbarnes redhat com>
Date:   Thu Jan 17 19:54:11 2013 -0500

    Add e_spell_checker_list_active_languages()
    
    Returns a NULL-terminated array of language codes actively being used
    for spell checking.

 doc/reference/libeutil/libeutil-sections.txt |    1 +
 e-util/e-spell-checker.c                     |   47 ++++++++++++++++++++++++++
 e-util/e-spell-checker.h                     |    3 ++
 3 files changed, 51 insertions(+), 0 deletions(-)
---
diff --git a/doc/reference/libeutil/libeutil-sections.txt b/doc/reference/libeutil/libeutil-sections.txt
index 10d608f..8eb211d 100644
--- a/doc/reference/libeutil/libeutil-sections.txt
+++ b/doc/reference/libeutil/libeutil-sections.txt
@@ -3662,6 +3662,7 @@ e_spell_checker_ref_dictionary
 e_spell_checker_get_enchant_dict
 e_spell_checker_get_language_active
 e_spell_checker_set_language_active
+e_spell_checker_list_active_languages
 e_spell_checker_learn_word
 e_spell_checker_ignore_word
 <SUBSECTION Standard>
diff --git a/e-util/e-spell-checker.c b/e-util/e-spell-checker.c
index 5f51685..67224c2 100644
--- a/e-util/e-spell-checker.c
+++ b/e-util/e-spell-checker.c
@@ -593,6 +593,53 @@ e_spell_checker_set_language_active (ESpellChecker *checker,
 }
 
 /**
+ * e_spell_checker_list_active_languages:
+ * @checker: an #ESpellChecker
+ * @n_languages: return location for the number of active languages, or %NULL
+ *
+ * Returns a %NULL-terminated array of language codes actively being used
+ * for spell checking.  Free the returned array with g_strfreev().
+ *
+ * Returns: a %NULL-teriminated array of language codes
+ **/
+gchar **
+e_spell_checker_list_active_languages (ESpellChecker *checker,
+                                       guint *n_languages)
+{
+	GHashTable *active_dictionaries;
+	GList *list, *link;
+	gchar **active_languages;
+	guint size;
+	gint ii = 0;
+
+	g_return_val_if_fail (E_IS_SPELL_CHECKER (checker), NULL);
+
+	active_dictionaries = checker->priv->active_dictionaries;
+	list = g_hash_table_get_keys (active_dictionaries);
+	size = g_hash_table_size (active_dictionaries);
+
+	active_languages = g_new0 (gchar *, size + 1);
+
+	list = g_list_sort (list, (GCompareFunc) e_spell_dictionary_compare);
+
+	for (link = list; link != NULL; link = g_list_next (link)) {
+		ESpellDictionary *dictionary;
+		const gchar *language_code;
+
+		dictionary = E_SPELL_DICTIONARY (link->data);
+		language_code = e_spell_dictionary_get_code (dictionary);
+		active_languages[ii++] = g_strdup (language_code);
+	}
+
+	if (n_languages != NULL)
+		*n_languages = size;
+
+	g_list_free (list);
+
+	return active_languages;
+}
+
+/**
  * e_spell_checker_ignore_word:
  * @checker: an #ESpellChecker
  * @word: word to ignore for the rest of session
diff --git a/e-util/e-spell-checker.h b/e-util/e-spell-checker.h
index 78dcb23..c39c530 100644
--- a/e-util/e-spell-checker.h
+++ b/e-util/e-spell-checker.h
@@ -77,6 +77,9 @@ void		e_spell_checker_set_language_active
 						(ESpellChecker *checker,
 						 const gchar *language_code,
 						 gboolean active);
+gchar **	e_spell_checker_list_active_languages
+						(ESpellChecker *checker,
+						 guint *n_languages);
 void		e_spell_checker_learn_word	(ESpellChecker *checker,
 						 const gchar *word);
 void		e_spell_checker_ignore_word	(ESpellChecker *checker,