write pinyin_free_candidates

3 files changed, 21 insertions, 1 deletions

diff --git a/src/libpinyin.ver b/src/libpinyin.ver
index 6422147..eb9e6d8 100644
--- a/src/libpinyin.ver
+++ b/src/libpinyin.ver
@@ -22,7 +22,7 @@ LIBPINYIN {
         pinyin_get_candidates;
         pinyin_get_full_pinyin_candidates;
         pinyin_choose_candidate;
-        pinyin_choose_full_pinyin_candidate;
+        pinyin_free_candidates;
         pinyin_clear_constraint;
         pinyin_clear_constraints;
         pinyin_translate_token;
diff --git a/src/pinyin.cpp b/src/pinyin.cpp
index dcea7ad..d919c03 100644
--- a/src/pinyin.cpp
+++ b/src/pinyin.cpp
@@ -1552,6 +1552,14 @@ int pinyin_choose_candidate(pinyin_instance_t * instance,
 }
 
 
+bool pinyin_free_candidates(pinyin_instance_t * instance,
+                            CandidateVector candidates) {
+    _free_candidates(candidates);
+    g_array_free(candidates, TRUE);
+    return true;
+}
+
+
 bool pinyin_clear_constraint(pinyin_instance_t * instance,
                              size_t offset){
     pinyin_context_t * & context = instance->m_context;
diff --git a/src/pinyin.h b/src/pinyin.h
index 94a7846..0792358 100644
--- a/src/pinyin.h
+++ b/src/pinyin.h
@@ -405,6 +405,18 @@ int pinyin_choose_candidate(pinyin_instance_t * instance,
                             lookup_candidate_t * candidate);
 
 /**
+ * pinyin_free_candidates:
+ * @instance: the pinyin instance.
+ * @candidates: the GArray of lookup_candidate_t candidates.
+ * @returns: whether the free operation succeeded.
+ *
+ * Free the candidates.
+ *
+ */
+bool pinyin_free_candidates(pinyin_instance_t * instance,
+                            CandidateVector candidates);
+
+/**
  * pinyin_clear_constraint:
  * @instance: the pinyin instance.
  * @offset: the offset in the pinyin keys.