diff options
author | Peng Wu <alexepico@gmail.com> | 2010-09-21 10:31:59 +0800 |
---|---|---|
committer | Peng Wu <alexepico@gmail.com> | 2010-09-21 10:31:59 +0800 |
commit | e3b77ed49636d108f725423855797c4324f32a43 (patch) | |
tree | 2b0336a966151e60ee7a5a0168cb865554b05919 /utils/storage | |
parent | ed7962be8ea097dc632a6a2fd7636a0c01d6bd24 (diff) | |
download | libpinyin-e3b77ed49636d108f725423855797c4324f32a43.tar.gz libpinyin-e3b77ed49636d108f725423855797c4324f32a43.tar.xz libpinyin-e3b77ed49636d108f725423855797c4324f32a43.zip |
re-fine the tag utility header
Diffstat (limited to 'utils/storage')
-rw-r--r-- | utils/storage/tag_utility.h | 28 |
1 files changed, 20 insertions, 8 deletions
diff --git a/utils/storage/tag_utility.h b/utils/storage/tag_utility.h index ac97dd4..b852ad5 100644 --- a/utils/storage/tag_utility.h +++ b/utils/storage/tag_utility.h @@ -22,21 +22,33 @@ #ifndef TAG_UTILITY_H #define TAG_UTILITY_H +/* Note: the optional tag has been removed from the first implementation. + * Maybe the optional tag will be added back later. + */ + bool taglib_init(); /* Note: most string array (const char *) are null pointer terminated. */ -bool taglib_add_tag(int line_type, const char * line_tag, int num_of_values, const char * required_tags[], const char * optional_tags[], const char * ignored_tags[]); +bool taglib_add_tag(int line_type, const char * line_tag, int num_of_values, const char * required_tags[], const char * ignored_tags[]); -/* most parameters are Array of string (const char *). - * required tags are listed in the beginning of the array. - */ -bool taglib_read(const char * input_line, int & line_type, GPtrArray * values, GPtrArray * tagnames, GPtrArray * tagvalues); +/* most parameters are hash table of string (const char *). */ +bool taglib_read(const char * input_line, int & line_type, GPtrArray * values, GHashTable * required); /* Note: taglib_write is omited, as printf is more suitable for this. */ -bool taglib_report_status(int line_type); +/* Note the following function is only available when the optional tag exists. + * bool taglib_report_status(int line_type); + */ + +/* remove the tag of type line_type. */ +bool taglib_remove_tag(int line_type); + +/* the following functions are used to save current known tag list in stack. + * Used when the parsing context is changed. + */ +bool taglib_push_state(); +bool taglib_pop_state(); -/* clear up the tag of type line_type. */ -bool taglib_fini(int line_type); +bool taglib_fini(); #endif |