7. 詞音

7.1 前言

詞音為詞的讀音。

7.2 tabeTsiYinDBOpen()

struct TsiYinDB *tabeTsiYinDBOpen(int type, const char *db_name, int flags);

開啟一個詞音庫。type 是詞庫的種類，目前只有 DB_TYPE_DB 一種， 也就是用 Berkeley DB。flags 是這個資料庫的一些特性，如下：

• DB_FLAG_OVERWRITE：如果在寫入詞音庫時已有重覆的詞音，覆寫掉它。
• DB_FLAG_CREATEDB：如果開啟詞音庫時找不到此詞音庫，新增該檔。
• DB_FLAG_READONLY：開啟詞音庫為唯讀狀態。不能與前兩個 flag 混用。

傳回的 TsiYinDB 就是當呼叫其他詞庫處理函數時第一個參數。

7.3 yindb->Close()

void yindb->Close(struct TsiYinDB *yindb);

關閉詞音庫。

7.4 yindb->RecordNumber()

int tabeTsiYinDBRecordNumber(struct Big5TsiYinDB *yindb);

查詢該詞音庫中共有多少筆詞音。

7.5 yindb->Put()

int yindb->Put(struct TsiYinDB *yindb, struct TsiYinInfo *yin);

將 TsiYinInfo 中的 yin、yinlen、tsinum、tsidata 存入詞音庫中。

7.6 yindb->Get()

int yindb->Get(struct TsiYinDB *yindb, struct TsiYinInfo *yin);

查詢詞庫中是否有 TsiYinInfo 中的 yin 這個詞音。 有的話將其他資料由詞音庫中填入 TsiYinInfo 中。

7.7 yindb->CursorSet()

int yindb->CursorSet(struct TsiYinDB *yindb, struct TsiYinInfo *tsiyin);

將詞音庫的游標設到 TsiYinInfo 的 yin 所指向的地方。如果 yin 不存在， 則指向第一筆記錄。同時也將該詞填入 TsiYinInfo 中。

7.8 yindb->CursorNext()

int yindb->CursorNext(struct TsiYinDB *yindb, struct TsiYinInfo *yin);

讀取下一筆詞音。

7.9 yindb->CursorPrev()

int yindb->CursorPrev(struct TsiYinDB *yindb, struct TsiYinInfo *yin);

讀取上一筆詞音。