add comments for full pinyin parser2
[platform/upstream/libpinyin.git] / src / storage / pinyin_parser2.cpp
1 /* 
2  *  libpinyin
3  *  Library to deal with pinyin.
4  *  
5  *  Copyright (C) 2011 Peng Wu <alexepico@gmail.com>
6  *  
7  *  This program is free software; you can redistribute it and/or modify
8  *  it under the terms of the GNU General Public License as published by
9  *  the Free Software Foundation; either version 2 of the License, or
10  *  (at your option) any later version.
11  * 
12  *  This program is distributed in the hope that it will be useful,
13  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
14  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15  *  GNU General Public License for more details.
16  *  
17  *  You should have received a copy of the GNU General Public License
18  *  along with this program; if not, write to the Free Software
19  *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
20  */
21
22
23 #include "pinyin_parser2.h"
24 #include <ctype.h>
25 #include <assert.h>
26 #include <stdio.h>
27 #include <string.h>
28 #include "stl_lite.h"
29 #include "pinyin_phrase2.h"
30 #include "pinyin_custom2.h"
31 #include "chewing_key.h"
32 #include "pinyin_parser_table.h"
33 #include "double_pinyin_table.h"
34 #include "chewing_table.h"
35
36
37 using namespace pinyin;
38
39 static bool check_pinyin_options(pinyin_option_t options, const pinyin_index_item_t * item) {
40     guint32 flags = item->m_flags;
41     assert (flags & IS_PINYIN);
42
43     /* handle incomplete pinyin. */
44     if (flags & PINYIN_INCOMPLETE) {
45         if (!(options & PINYIN_INCOMPLETE))
46             return false;
47     }
48
49     /* handle correct pinyin, currently only one flag per item. */
50     flags &= PINYIN_CORRECT_ALL;
51     options &= PINYIN_CORRECT_ALL;
52
53     if (flags) {
54         if ((flags & options) != flags)
55             return false;
56     }
57
58     return true;
59 }
60
61 static bool check_chewing_options(pinyin_option_t options, const chewing_index_item_t * item) {
62     guint32 flags = item->m_flags;
63     assert (flags & IS_CHEWING);
64
65     /* handle incomplete chewing. */
66     if (flags & CHEWING_INCOMPLETE) {
67         if (!(options & CHEWING_INCOMPLETE))
68             return false;
69     }
70
71     return true;
72 }
73
74
75 gint ChewingKey::get_table_index() {
76     assert(m_initial <  CHEWING_NUMBER_OF_INITIALS);
77     assert(m_middle < CHEWING_NUMBER_OF_MIDDLES);
78     assert(m_final < CHEWING_NUMBER_OF_FINALS);
79
80     gint index = chewing_key_table[(m_initial * CHEWING_NUMBER_OF_MIDDLES + m_middle) * CHEWING_NUMBER_OF_FINALS + m_final];
81     return index == -1 ? 0 : index;
82 }
83
84 gchar * ChewingKey::get_pinyin_string() {
85     assert(m_tone < CHEWING_NUMBER_OF_TONES);
86     gint index = get_table_index();
87     assert(index < G_N_ELEMENTS(content_table));
88     const content_table_item_t & item = content_table[index];
89
90     if (CHEWING_ZERO_TONE == m_tone) {
91         return g_strdup(item.m_pinyin_str);
92     } else {
93         return g_strdup_printf("%s%d", item.m_pinyin_str, m_tone);
94     }
95 }
96
97 gchar * ChewingKey::get_chewing_string() {
98     assert(m_tone < CHEWING_NUMBER_OF_TONES);
99     gint index = get_table_index();
100     assert(index < G_N_ELEMENTS(content_table));
101     const content_table_item_t & item = content_table[index];
102
103     if (CHEWING_ZERO_TONE == m_tone) {
104         return g_strdup(item.m_chewing_str);
105     } else {
106         return g_strdup_printf("%s%s", item.m_chewing_str,
107                                chewing_tone_table[m_tone]);
108     }
109 }
110
111
112 /* Pinyin Parsers */
113
114 /* internal information for pinyin parsers. */
115 struct parse_value_t{
116     ChewingKey m_key;
117     ChewingKeyRest m_key_rest;
118     gint16 m_num_keys;
119     gint16 m_parsed_len;
120     gint16 m_last_step;
121
122     /* constructor */
123 public:
124     parse_value_t(){
125         m_num_keys = 0;
126         m_parsed_len = 0;
127         m_last_step = -1;
128     }
129 };
130
131 const guint16 max_full_pinyin_length   = 7;  /* include tone. */
132
133 const guint16 max_double_pinyin_length = 3;  /* include tone. */
134
135 const guint16 max_chewing_length       = 4;  /* include tone. */
136
137 static bool compare_pinyin_less_than(const pinyin_index_item_t & lhs,
138                                      const pinyin_index_item_t & rhs){
139     return 0 > strcmp(lhs.m_pinyin_input, rhs.m_pinyin_input);
140 }
141
142 static inline bool search_pinyin_index(pinyin_option_t options,
143                                        const char * pinyin,
144                                        ChewingKey & key){
145     pinyin_index_item_t item;
146     memset(&item, 0, sizeof(item));
147     item.m_pinyin_input = pinyin;
148
149     std_lite::pair<const pinyin_index_item_t *,
150                    const pinyin_index_item_t *> range;
151     range = std_lite::equal_range
152         (pinyin_index, pinyin_index + G_N_ELEMENTS(pinyin_index),
153          item, compare_pinyin_less_than);
154
155     guint16 range_len = range.second - range.first;
156     assert(range_len <= 1);
157     if (range_len == 1) {
158         const pinyin_index_item_t * index = range.first;
159
160         if (!check_pinyin_options(options, index))
161             return false;
162
163         key = content_table[index->m_table_index].m_chewing_key;
164         assert(key.get_table_index() == index->m_table_index);
165         return true;
166     }
167
168     return false;
169 }
170
171 static bool compare_chewing_less_than(const chewing_index_item_t & lhs,
172                                       const chewing_index_item_t & rhs){
173     return 0 > strcmp(lhs.m_chewing_input, rhs.m_chewing_input);
174 }
175
176 static inline bool search_chewing_index(pinyin_option_t options,
177                                         const char * chewing,
178                                         ChewingKey & key){
179     chewing_index_item_t item;
180     memset(&item, 0, sizeof(item));
181     item.m_chewing_input = chewing;
182
183     std_lite::pair<const chewing_index_item_t *,
184                    const chewing_index_item_t *> range;
185     range = std_lite::equal_range
186         (chewing_index, chewing_index + G_N_ELEMENTS(chewing_index),
187          item, compare_chewing_less_than);
188
189     guint16 range_len = range.second - range.first;
190     assert (range_len <= 1);
191
192     if (range_len == 1) {
193         const chewing_index_item_t * index = range.first;
194
195         if (!check_chewing_options(options, index))
196             return false;
197
198         key = content_table[index->m_table_index].m_chewing_key;
199         assert(key.get_table_index() == index->m_table_index);
200         return true;
201     }
202
203     return false;
204 }
205
206 /* Full Pinyin Parser */
207 FullPinyinParser2::FullPinyinParser2 (){
208     m_parse_steps = g_array_new(TRUE, FALSE, sizeof(parse_value_t));
209 }
210
211
212 bool FullPinyinParser2::parse_one_key (pinyin_option_t options,
213                                        ChewingKey & key,
214                                        const char * pinyin, int len) const {
215     /* "'" are not accepted in parse_one_key. */
216     gchar * input = g_strndup(pinyin, len);
217     assert(NULL == strchr(input, '\''));
218
219     guint16 tone = CHEWING_ZERO_TONE; guint16 tone_pos = 0;
220     guint16 parsed_len = len;
221     key = ChewingKey();
222
223     if (options & USE_TONE) {
224         /* find the tone in the last character. */
225         char chr = input[parsed_len - 1];
226         if ( '0' < chr && chr <= '5' ) {
227             tone = chr - '0';
228             parsed_len --;
229             tone_pos = parsed_len;
230         }
231     }
232
233     /* parse pinyin core staff here. */
234
235     /* Note: optimize here? */
236     input[parsed_len] = '\0';
237     if (!search_pinyin_index(options, input, key)) {
238         g_free(input);
239         return false;
240     }
241
242     if (options & USE_TONE) {
243         /* post processing tone. */
244         if ( parsed_len == tone_pos ) {
245             if (tone != CHEWING_ZERO_TONE) {
246                 key.m_tone = tone;
247                 parsed_len ++;
248             }
249         }
250     }
251
252     g_free(input);
253     return parsed_len == len;
254 }
255
256
257 int FullPinyinParser2::parse (pinyin_option_t options, ChewingKeyVector & keys,
258                               ChewingKeyRestVector & key_rests,
259                               const char *str, int len) const {
260     int i;
261     /* clear arrays. */
262     g_array_set_size(keys, 0);
263     g_array_set_size(key_rests, 0);
264
265     /* init m_parse_steps, and prepare dynamic programming. */
266     int step_len = len + 1;
267     g_array_set_size(m_parse_steps, 0);
268     parse_value_t value;
269     for (i = 0; i < step_len; ++i) {
270         g_array_append_val(m_parse_steps, value);
271     }
272
273     size_t next_sep = 0;
274     gchar * input = g_strndup(str, len);
275     parse_value_t * curstep = NULL, * nextstep = NULL;
276
277     for (i = 0; i < len; ++i) {
278         if (input[i] == '\'') {
279             curstep = &g_array_index(m_parse_steps, parse_value_t, i);
280             nextstep = &g_array_index(m_parse_steps, parse_value_t, i + 1);
281
282             /* propagate current step into next step. */
283             nextstep->m_key = ChewingKey();
284             nextstep->m_key_rest = ChewingKeyRest();
285             nextstep->m_num_keys = curstep->m_num_keys;
286             nextstep->m_parsed_len = curstep->m_parsed_len + 1;
287             nextstep->m_last_step = i;
288             next_sep = 0;
289             continue;
290         }
291
292         /* forward to next "'" */
293         if ( 0 == next_sep ) {
294             int k;
295             for (k = i;  k < len; ++k) {
296                 if (input[k] == '\'')
297                     break;
298             }
299             next_sep = k;
300         }
301
302 #if 0
303         /* Heuristic Method:
304          *   do maximum forward match first. */
305         for (size_t pos = i; pos < next_sep; ++pos) {
306             curstep = &g_array_index(m_parse_steps, parse_value_t, pos);
307             size_t try_len = std_lite::min
308                 (pos + max_full_pinyin_length, next_sep);
309             for (size_t n = try_len; n > pos; --n) {
310                 nextstep = &g_array_index(m_parse_steps, parse_value_t, n);
311
312                 /* gen next step */
313                 const char * onepinyin = input + pos;
314                 gint16 onepinyinlen = n - pos;
315                 value = parse_value_t();
316
317                 ChewingKey key; ChewingKeyRest rest;
318                 bool parsed = parse_one_key
319                     (options, key, onepinyin, onepinyinlen);
320                 rest.m_raw_begin = pos; rest.m_raw_end = n;
321
322                 if (!parsed)
323                     continue;
324
325                 //printf("onepinyin:%s len:%d\n", onepinyin, onepinyinlen);
326                 value.m_key = key; value.m_key_rest = rest;
327                 value.m_num_keys = curstep->m_num_keys + 1;
328                 value.m_parsed_len = curstep->m_parsed_len + onepinyinlen;
329                 value.m_last_step = pos;
330
331                 /* save next step */
332                 if (-1 == nextstep->m_last_step)
333                     *nextstep = value;
334                 if (value.m_parsed_len > nextstep->m_parsed_len)
335                     *nextstep = value;
336                 if (value.m_parsed_len == nextstep->m_parsed_len &&
337                     value.m_num_keys < nextstep->m_num_keys)
338                     *nextstep = value;
339
340                 /* maximum forward, set pos to n in next iteration. */
341                 pos = n - 1;
342                 break;
343             }
344         }
345 #endif
346
347         /* dynamic programming here. */
348         /* for (size_t m = i; m < next_sep; ++m) */
349         {
350             size_t m = i;
351             curstep = &g_array_index(m_parse_steps, parse_value_t, m);
352             size_t try_len = std_lite::min
353                 (m + max_full_pinyin_length, next_sep);
354             for (size_t n = m + 1; n < try_len + 1; ++n) {
355                 nextstep = &g_array_index(m_parse_steps, parse_value_t, n);
356
357                 /* gen next step */
358                 const char * onepinyin = input + m;
359                 gint16 onepinyinlen = n - m;
360                 value = parse_value_t();
361
362                 ChewingKey key; ChewingKeyRest rest;
363                 bool parsed = parse_one_key
364                     (options, key, onepinyin, onepinyinlen);
365                 rest.m_raw_begin = m; rest.m_raw_end = n;
366                 if (!parsed)
367                     continue;
368
369                 //printf("onepinyin:%s len:%d\n", onepinyin, onepinyinlen);
370
371                 value.m_key = key; value.m_key_rest = rest;
372                 value.m_num_keys = curstep->m_num_keys + 1;
373                 value.m_parsed_len = curstep->m_parsed_len + onepinyinlen;
374                 value.m_last_step = m;
375
376                 /* save next step */
377                 /* no previous result */
378                 if (-1 == nextstep->m_last_step)
379                     *nextstep = value;
380                 /* prefer the longest pinyin */
381                 if (value.m_parsed_len > nextstep->m_parsed_len)
382                     *nextstep = value;
383                 /* prefer the shortest keys with the same pinyin length */
384                 if (value.m_parsed_len == nextstep->m_parsed_len &&
385                     value.m_num_keys < nextstep->m_num_keys)
386                     *nextstep = value;
387
388                 /* handle with the same pinyin length and the number of keys */
389                 if (value.m_parsed_len == nextstep->m_parsed_len &&
390                     value.m_num_keys == nextstep->m_num_keys) {
391
392                     /* prefer the complete pinyin with shengmu
393                      * over without shengmu,
394                      * ex: "kaneiji" -> "ka'nei'ji".
395                      */
396                     if ((value.m_key.m_initial != CHEWING_ZERO_INITIAL &&
397                          !(value.m_key.m_middle == CHEWING_ZERO_MIDDLE &&
398                            value.m_key.m_final == CHEWING_ZERO_FINAL)) &&
399                         nextstep->m_key.m_initial == CHEWING_ZERO_INITIAL)
400                         *nextstep = value;
401
402                     /* prefer the complete pinyin 'er'
403                      * over the in-complete pinyin 'r',
404                      * ex: "xierqi" -> "xi'er'qi."
405                      */
406                     if ((value.m_key.m_initial == CHEWING_ZERO_INITIAL &&
407                         value.m_key.m_middle == CHEWING_ZERO_MIDDLE &&
408                         value.m_key.m_final == CHEWING_ER) &&
409                         (nextstep->m_key.m_initial == CHEWING_R &&
410                          nextstep->m_key.m_middle == CHEWING_ZERO_MIDDLE &&
411                          nextstep->m_key.m_final == CHEWING_ZERO_FINAL))
412                         *nextstep = value;
413
414                     /* prefer the 'a' at the end of clause,
415                      * ex: "zheyanga$" -> "zhe'yang'a$".
416                      */
417                     if (value.m_parsed_len == len &&
418                         (nextstep->m_key.m_initial != CHEWING_ZERO_INITIAL &&
419                          nextstep->m_key.m_final == CHEWING_A) &&
420                         (value.m_key.m_initial == CHEWING_ZERO_INITIAL &&
421                          value.m_key.m_middle == CHEWING_ZERO_MIDDLE &&
422                          value.m_key.m_final == CHEWING_A))
423                         *nextstep = value;
424                 }
425             }
426         }
427     }
428
429     /* final step for back tracing. */
430     gint16 parsed_len = final_step(step_len, keys, key_rests);
431
432     /* post processing for re-split table. */
433     if (options & USE_RESPLIT_TABLE) {
434         post_process(options, keys, key_rests);
435     }
436
437     g_free(input);
438     return parsed_len;
439 }
440
441 int FullPinyinParser2::final_step(size_t step_len, ChewingKeyVector & keys,
442                                   ChewingKeyRestVector & key_rests) const{
443     int i;
444     gint16 parsed_len = 0;
445     parse_value_t * curstep = NULL;
446
447     /* find longest match, which starts from the beginning of input. */
448     for (i = step_len - 1; i >= 0; --i) {
449         curstep = &g_array_index(m_parse_steps, parse_value_t, i);
450         if (i == curstep->m_parsed_len)
451             break;
452     }
453     /* prepare saving. */
454     parsed_len = curstep->m_parsed_len;
455     gint16 num_keys = curstep->m_num_keys;
456     g_array_set_size(keys, num_keys);
457     g_array_set_size(key_rests, num_keys);
458
459     /* save the match. */
460     while (curstep->m_last_step != -1) {
461         gint16 pos = curstep->m_num_keys - 1;
462
463         /* skip "'" */
464         if (0 != curstep->m_key.get_table_index()) {
465             ChewingKey * key = &g_array_index(keys, ChewingKey, pos);
466             ChewingKeyRest * rest = &g_array_index
467                 (key_rests, ChewingKeyRest, pos);
468             *key = curstep->m_key; *rest = curstep->m_key_rest;
469         }
470
471         /* back ward */
472         curstep = &g_array_index(m_parse_steps, parse_value_t,
473                                  curstep->m_last_step);
474     }
475     return parsed_len;
476 }
477
478
479 bool FullPinyinParser2::post_process(pinyin_option_t options,
480                                      ChewingKeyVector & keys,
481                                      ChewingKeyRestVector & key_rests) const {
482     int i;
483     assert(keys->len == key_rests->len);
484     gint16 num_keys = keys->len;
485
486     ChewingKey * cur_key = NULL, * next_key = NULL;
487     ChewingKeyRest * cur_rest = NULL, * next_rest = NULL;
488     guint16 next_tone = CHEWING_ZERO_TONE;
489
490     for (i = 0; i < num_keys - 1; ++i) {
491         cur_rest = &g_array_index(key_rests, ChewingKeyRest, i);
492         next_rest = &g_array_index(key_rests, ChewingKeyRest, i + 1);
493
494         /* some "'" here */
495         if (cur_rest->m_raw_end != next_rest->m_raw_begin)
496             continue;
497
498         cur_key = &g_array_index(keys, ChewingKey, i);
499         next_key = &g_array_index(keys, ChewingKey, i + 1);
500
501         /* some tone here */
502         if (CHEWING_ZERO_TONE != cur_key->m_tone)
503             continue;
504
505         if (options & USE_TONE) {
506             next_tone = next_key->m_tone;
507             next_key->m_tone = CHEWING_ZERO_TONE;
508         }
509
510         /* lookup re-split table */
511         size_t k;
512         const resplit_table_item_t * item = NULL;
513         for (k = 0; k < G_N_ELEMENTS(resplit_table); ++k) {
514             item = resplit_table + k;
515             /* no ops */
516             if (item->m_orig_freq >= item->m_new_freq)
517                 continue;
518
519             /* use pinyin_exact_compare2 here. */
520             if (0 == pinyin_exact_compare2(item->m_orig_keys,
521                                            cur_key, 2))
522                 break;
523
524         }
525
526         /* find the match */
527         if (k < G_N_ELEMENTS(resplit_table)) {
528             /* do re-split */
529             item = resplit_table + k;
530             *cur_key = item->m_new_keys[0];
531             *next_key = item->m_new_keys[1];
532             /* assumes only moved one char in gen_all_resplit script. */
533             cur_rest->m_raw_end ++;
534             next_rest->m_raw_begin ++;
535         }
536
537         /* save back tones */
538         if (options & USE_TONE) {
539             next_key->m_tone = next_tone;
540         }
541     }
542
543     return true;
544 }
545
546 #define IS_KEY(x)   (('a' <= x && x <= 'z') || x == ';')
547
548 bool DoublePinyinParser2::parse_one_key(pinyin_option_t options,
549                                         ChewingKey & key,
550                                         const char *str, int len) const {
551     options &= ~(PINYIN_CORRECT_ALL|PINYIN_AMB_ALL);
552
553     if (1 == len) {
554         if (!(options & PINYIN_INCOMPLETE))
555             return false;
556
557         char ch = str[0];
558         if (!IS_KEY(ch))
559             return false;
560
561         int charid = ch == ';' ? 26 : ch - 'a';
562         const char * sheng = m_shengmu_table[charid].m_shengmu;
563         if (NULL == sheng || strcmp(sheng, "'") == 0)
564             return false;
565
566         if (search_pinyin_index(options, sheng, key)) {
567             return true;
568         } else {
569             return false;
570         }
571     }
572
573     ChewingTone tone = CHEWING_ZERO_TONE;
574     options &= ~(PINYIN_INCOMPLETE|CHEWING_INCOMPLETE);
575
576     /* parse tone */
577     if (3 == len) {
578         if (!(options & USE_TONE))
579             return false;
580         char ch = str[2];
581         if (!('0' < ch && ch <= '5'))
582             return false;
583         tone = (ChewingTone) (ch - '0');
584     }
585
586     if (2 == len || 3 == len) {
587         /* parse shengmu here. */
588         char ch = str[0];
589         if (!IS_KEY(ch))
590             return false;
591
592         int charid = ch == ';' ? 26 : ch - 'a';
593         const char * sheng = m_shengmu_table[charid].m_shengmu;
594         if (NULL == sheng)
595             return false;
596         if (strcmp(sheng, "'") == 0)
597             sheng = "";
598
599         /* parse yunmu here. */
600         ch = str[1];
601         if (!IS_KEY(ch))
602             return false;
603
604         charid = ch == ';' ? 26 : ch - 'a';
605         /* first yunmu */
606         const char * yun = m_yunmu_table[charid].m_yunmus[0];
607         if (NULL == yun)
608             return false;
609
610         gchar * pinyin = g_strdup_printf("%s%s", sheng, yun);
611         if (search_pinyin_index(options, pinyin, key)) {
612             key.m_tone = tone;
613             g_free(pinyin);
614             return true;
615         }
616         g_free(pinyin);
617
618         /* second yunmu */
619         yun = m_yunmu_table[charid].m_yunmus[1];
620         if (NULL == yun)
621             return false;
622
623         pinyin = g_strdup_printf("%s%s", sheng, yun);
624         if (search_pinyin_index(options, pinyin, key)) {
625             key.m_tone = tone;
626             g_free(pinyin);
627             return true;
628         }
629         g_free(pinyin);
630
631     }
632
633     return false;
634 }
635
636
637 /* only 'a'-'z' and ';' are accepted here. */
638 int DoublePinyinParser2::parse(pinyin_option_t options, ChewingKeyVector & keys,
639                                ChewingKeyRestVector & key_rests,
640                                const char *str, int len) const {
641     g_array_set_size(keys, 0);
642     g_array_set_size(key_rests, 0);
643
644     int maximum_len = 0; int i;
645     /* probe the longest possible double pinyin string. */
646     for (i = 0; i < len; ++i) {
647         const char ch = str[i];
648         if (!(IS_KEY(ch) || ('0' < ch && ch <= '5')))
649             break;
650     }
651     maximum_len = i;
652
653     /* maximum forward match for double pinyin. */
654     int parsed_len = 0;
655     while (parsed_len < maximum_len) {
656         const char * cur_str = str + parsed_len;
657         i = std_lite::min(maximum_len - parsed_len,
658                           (int)max_double_pinyin_length);
659
660         ChewingKey key; ChewingKeyRest key_rest;
661         for (; i > 0; --i) {
662             bool success = parse_one_key(options, key, cur_str, i);
663             if (success)
664                 break;
665         }
666
667         if (0 == i)        /* no more possible double pinyins. */
668             break;
669
670         key_rest.m_raw_begin = parsed_len; key_rest.m_raw_end = parsed_len + i;
671         parsed_len += i;
672
673         /* save the pinyin */
674         g_array_append_val(keys, key);
675         g_array_append_val(key_rests, key_rest);
676     }
677
678     return parsed_len;
679 }
680
681 #undef IS_KEY
682
683 bool DoublePinyinParser2::set_scheme(DoublePinyinScheme scheme) {
684
685     switch (scheme) {
686     case DOUBLE_PINYIN_ZRM:
687         m_shengmu_table = double_pinyin_zrm_sheng;
688         m_yunmu_table   = double_pinyin_zrm_yun;
689         return true;
690     case DOUBLE_PINYIN_MS:
691         m_shengmu_table = double_pinyin_mspy_sheng;
692         m_yunmu_table   = double_pinyin_mspy_yun;
693         return true;
694     case DOUBLE_PINYIN_ZIGUANG:
695         m_shengmu_table = double_pinyin_zgpy_sheng;
696         m_yunmu_table   = double_pinyin_zgpy_yun;
697         return true;
698     case DOUBLE_PINYIN_ABC:
699         m_shengmu_table = double_pinyin_abc_sheng;
700         m_yunmu_table   = double_pinyin_abc_yun;
701         return true;
702     case DOUBLE_PINYIN_PYJJ:
703         m_shengmu_table = double_pinyin_pyjj_sheng;
704         m_yunmu_table   = double_pinyin_pyjj_yun;
705         return true;
706     case DOUBLE_PINYIN_XHE:
707         m_shengmu_table = double_pinyin_xhe_sheng;
708         m_yunmu_table   = double_pinyin_xhe_yun;
709         return true;
710     case DOUBLE_PINYIN_CUSTOMIZED:
711         assert(FALSE);
712     };
713
714     return false; /* no such scheme. */
715 }
716
717 /* the chewing string must be freed with g_free. */
718 static bool search_chewing_symbols(const chewing_symbol_item_t * symbol_table,
719                                    const char key, const char ** chewing) {
720     *chewing = NULL;
721     /* just iterate the table, as we only have < 50 items. */
722     while (symbol_table->m_input != '\0') {
723         if (symbol_table->m_input == key) {
724             *chewing = symbol_table->m_chewing;
725             return true;
726         }
727         symbol_table ++;
728     }
729     return false;
730 }
731
732 static bool search_chewing_tones(const chewing_tone_item_t * tone_table,
733                                  const char key, char * tone) {
734     *tone = CHEWING_ZERO_TONE;
735     /* just iterate the table, as we only have < 10 items. */
736     while (tone_table->m_input != '\0') {
737         if (tone_table->m_input == key) {
738             *tone = tone_table->m_tone;
739             return true;
740         }
741         tone_table ++;
742     }
743     return false;
744 }
745
746
747 bool ChewingParser2::parse_one_key(pinyin_option_t options,
748                                    ChewingKey & key,
749                                    const char *str, int len) const {
750     options &= ~(PINYIN_CORRECT_ALL|PINYIN_AMB_ALL);
751     char tone = CHEWING_ZERO_TONE;
752
753     int symbols_len = len;
754     /* probe whether the last key is tone key in str. */
755     if (options & USE_TONE) {
756         char ch = str[len - 1];
757         /* remove tone from input */
758         if (search_chewing_tones(m_tone_table, ch, &tone))
759             symbols_len --;
760     }
761
762     int i;
763     gchar * chewing = NULL; const char * onechar = NULL;
764
765     /* probe the possible chewing map in the rest of str. */
766     for (i = 0; i < symbols_len; ++i) {
767         if (!search_chewing_symbols(m_symbol_table, str[i], &onechar)) {
768             g_free(chewing);
769             return false;
770         }
771
772         if (!chewing) {
773             chewing = g_strdup(onechar);
774         } else {
775             gchar * tmp = chewing;
776             chewing = g_strconcat(chewing, onechar, NULL);
777             g_free(tmp);
778         }
779     }
780
781     /* search the chewing in the chewing index table. */
782     if (chewing && search_chewing_index(options, chewing, key)) {
783         /* save back tone if available. */
784         key.m_tone = tone;
785         g_free(chewing);
786         return true;
787     }
788
789     g_free(chewing);
790     return false;
791 }
792
793
794 /* only characters in chewing keyboard scheme are accepted here. */
795 int ChewingParser2::parse(pinyin_option_t options, ChewingKeyVector & keys,
796                           ChewingKeyRestVector & key_rests,
797                           const char *str, int len) const {
798     g_array_set_size(keys, 0);
799     g_array_set_size(key_rests, 0);
800
801     int maximum_len = 0; int i;
802     /* probe the longest possible chewing string. */
803     for (i = 0; i < len; ++i) {
804         if (!in_chewing_scheme(options, str[i], NULL))
805             break;
806     }
807     maximum_len = i;
808
809     /* maximum forward match for chewing. */
810     int parsed_len = 0;
811     while (parsed_len < maximum_len) {
812         const char * cur_str = str + parsed_len;
813         i = std_lite::min(maximum_len - parsed_len,
814                           (int)max_chewing_length);
815
816         ChewingKey key; ChewingKeyRest key_rest;
817         for (; i > 0; --i) {
818             bool success = parse_one_key(options, key, cur_str, i);
819             if (success)
820                 break;
821         }
822
823         if (0 == i)        /* no more possible chewings. */
824             break;
825
826         key_rest.m_raw_begin = parsed_len; key_rest.m_raw_end = parsed_len + i;
827         parsed_len += i;
828
829         /* save the pinyin. */
830         g_array_append_val(keys, key);
831         g_array_append_val(key_rests, key_rest);
832     }
833
834     return parsed_len;
835 }
836
837
838 bool ChewingParser2::set_scheme(ChewingScheme scheme) {
839     switch(scheme) {
840     case CHEWING_STANDARD:
841         m_symbol_table = chewing_standard_symbols;
842         m_tone_table   = chewing_standard_tones;
843         return true;
844     case CHEWING_IBM:
845         m_symbol_table = chewing_ibm_symbols;
846         m_tone_table   = chewing_ibm_tones;
847         return true;
848     case CHEWING_GINYIEH:
849         m_symbol_table = chewing_ginyieh_symbols;
850         m_tone_table   = chewing_ginyieh_tones;
851         return true;
852     case CHEWING_ETEN:
853         m_symbol_table = chewing_eten_symbols;
854         m_tone_table   = chewing_eten_tones;
855         return true;
856     }
857
858     return false;
859 }
860
861
862 bool ChewingParser2::in_chewing_scheme(pinyin_option_t options,
863                                        const char key, const char ** symbol)
864  const {
865     const gchar * chewing = NULL;
866     char tone = CHEWING_ZERO_TONE;
867
868     if (search_chewing_symbols(m_symbol_table, key, &chewing)) {
869         if (symbol)
870             *symbol = chewing;
871         return true;
872     }
873
874     if (!(options & USE_TONE))
875         return false;
876
877     if (search_chewing_tones(m_tone_table, key, &tone)) {
878         if (symbol)
879             *symbol = chewing_tone_table[tone];
880         return true;
881     }
882
883     return false;
884 }